Welcome to the Cosmetics repository for the Minecraft server onthepixel.net! Here, you can contribute new cosmetics such as Backpacks, Hats, Offhand Cosmetics, Capes, and Balloons by submitting a pull request.
Start by forking this repository. This allows you to make changes without directly modifying the original codebase.
Here are the cosmetic categories you can add:
- Backpacks: Place your backpack files in the
cosmetics/backpacks/
folder. - Hats: Place your hat files in the
cosmetics/hats/
folder. - Capes: Place your cape files in the
cosmetics/capes/
folder. - Balloons: Place your balloon files in the
cosmetics/balloons/
folder.
Ensure your files are properly formatted (e.g., textures as .png
, models as .json
).
If you add a new category or option, make sure to update the relevant configuration files in the config/
folder. Document any new parameters or variables you've introduced.
Before submitting a pull request, test your additions locally on your server to make sure everything works as expected.
Once you're ready, follow these steps:
- Commit your changes to your fork.
- Go to the repository page and create a pull request (PR).
- In your PR description, explain your changes in detail so reviewers understand what has been added.
- Example: "Added a new backpack cosmetic featuring a custom leather texture."
A team member will review your pull request to ensure everything meets our standards. Once the review is complete, your PR will be merged into the main repository.
Once your cosmetic is approved and merged, you can generate up to 100 codes (or more after discussion) through our Discord using the command:
/cosmetics
Players can redeem a cosmetic in-game by using the command:
/redeem (code)
This allows players to unlock and use the new cosmetic on onthepixel.net!
- File Format: All new files should be in the correct format. For example, textures should be
.png
and models should be.json
. - Naming Conventions: Follow the existing naming conventions for files and folders in the repository to maintain consistency.
- Copyright Compliance: Ensure all resources (textures, models, etc.) are either created by you or are free from copyright restrictions.
If you have any questions or need assistance, feel free to reach out via the GitHub repository or join our Discord server!
Have fun adding cosmetics! ✨🎮