# CrossCosmeticsPlus A comprehensive cross-platform cosmetic system for Minecraft servers supporting both Java and Bedrock players. Features custom armor sets, items, skins, and particle effects with full economy integration. ## Features - **Custom Armor Sets** - Armor with special abilities and custom textures - **Custom Items** - Items with unique abilities, enchantments, and cooldowns - **Player Skins** - Custom skins for Java Edition players - **Cosmetic Effects** - Particle trails and visual effects - **Economy Integration** - Vault support for purchasing cosmetics - **Bedrock Support** - Full Floodgate/Geyser compatibility with form-based UI - **Custom Model Data** - Resource pack support for custom textures - **Permission System** - Granular control over cosmetic access - **GUI System** - Interactive menus for browsing and equipping cosmetics ## Commands | Command | Description | Permission | |---------|-------------|------------| | `/cosmetics` | Open the cosmetics menu | `crosscosmetics.use` | | `/cosmeticadmin give ` | Give a cosmetic to a player | `crosscosmetics.admin` | | `/cosmeticadmin reload` | Reload configuration files | `crosscosmetics.admin` | **Aliases:** - `/cosmetics` - `/cosm`, `/skins` - `/cosmeticadmin` - `/cosma`, `/cadmin` ## Permissions ### Player Permissions - `crosscosmetics.use` - Access the cosmetics menu (default: true) - `crosscosmetics.free` - Get all cosmetics for free (default: false) ### Category Permissions - `crosscosmetics.skin.*` - Access to all skins - `crosscosmetics.cosmetic.*` - Access to all cosmetics - `crosscosmetics.armor.*` - Access to all armor sets - `crosscosmetics.item.*` - Access to all custom items ### Individual Item Permissions - `crosscosmetics.armor.` - Access to specific armor set - `crosscosmetics.item.` - Access to specific item - `crosscosmetics.cosmetic.` - Access to specific cosmetic - `crosscosmetics.skin.` - Access to specific skin ### Admin Permissions - `crosscosmetics.admin` - Full admin access (default: op) ## Configuration ### Main Config (`config.yml`) ```yaml prefix: '&8[&bCosmetics&8]&r' debug: false economy: enabled: true currency-symbol: '$' bedrock: enable-forms: true skin-change-enabled: true messages: no-permission: '&cYou do not have permission to use this!' insufficient-funds: '&cInsufficient funds! You need {amount}.' purchase-success: '&aSuccessfully purchased {item} for {cost}!' item-equipped: '&aEquipped {item}!' item-removed: '&cRemoved {item}!' ``` ## Adding Custom Armor Sets Armor sets are configured in `armor.yml`. Each set can have custom textures using Custom Model Data. ### Basic Armor Configuration ```yaml armor: dragon_set: name: "&cDragon Set" helmet: "NETHERITE_HELMET" chestplate: "NETHERITE_CHESTPLATE" leggings: "NETHERITE_LEGGINGS" boots: "NETHERITE_BOOTS" price: 1000.0 permission: "crosscosmetics.armor.dragon" free: false abilities: - "FIRE_RESISTANCE" - "STRENGTH" custom-model-data: 1 ``` ### Armor Configuration Options | Option | Description | Required | |--------|-------------|----------| | `name` | Display name (supports color codes) | Yes | | `helmet` | Helmet material (XMaterial) | Yes | | `chestplate` | Chestplate material (XMaterial) | Yes | | `leggings` | Leggings material (XMaterial) | Yes | | `boots` | Boots material (XMaterial) | Yes | | `price` | Cost to purchase | Yes | | `permission` | Permission required to use | Yes | | `free` | Whether the armor is free | Yes | | `abilities` | List of potion effects when worn | No | | `custom-model-data` | Custom model data ID for textures | No | ### Available Abilities Armor abilities grant potion effects when the full set is worn: - `STRENGTH` - Strength buff - `SPEED_BOOST` - Speed buff - `FIRE_RESISTANCE` - Fire immunity - `REGENERATION` - Health regeneration - `JUMP_BOOST` - Jump height increase - `RESISTANCE` - Damage reduction - `WATER_BREATHING` - Underwater breathing - `NIGHT_VISION` - Night vision ### Example: Creating a Custom Textured Armor Set ```yaml armor: emerald_warrior: name: "&aEmerald Warrior Set" helmet: "DIAMOND_HELMET" chestplate: "DIAMOND_CHESTPLATE" leggings: "DIAMOND_LEGGINGS" boots: "DIAMOND_BOOTS" price: 2500.0 permission: "crosscosmetics.armor.emeraldwarrior" free: false abilities: - "REGENERATION" - "RESISTANCE" custom-model-data: 100 ``` ## Adding Custom Items Items are configured in `items.yml`. Each item can have abilities, enchantments, and custom textures. ### Basic Item Configuration ```yaml items: lightning_staff: name: "&eLightning Staff" material: "BLAZE_ROD" price: 750.0 permission: "crosscosmetics.item.lightning" free: false abilities: - "LIGHTNING_STRIKE" lore: - "&7A staff that summons lightning" - "&7Right-click to strike enemies" - "" - "&eCooldown: 30 seconds" enchantments: KNOCKBACK: 2 UNBREAKING: 3 custom-model-data: 10 cooldown: 30 ``` ### Item Configuration Options | Option | Description | Required | |--------|-------------|----------| | `name` | Display name (supports color codes) | Yes | | `material` | Item material (XMaterial) | Yes | | `price` | Cost to purchase | Yes | | `permission` | Permission required to use | Yes | | `free` | Whether the item is free | Yes | | `abilities` | List of special abilities | No | | `lore` | Item description lines | No | | `enchantments` | Map of enchantments and levels | No | | `custom-model-data` | Custom model data ID for textures | No | | `cooldown` | Ability cooldown in seconds | No | ### Available Item Abilities - `STRENGTH` - Temporary strength boost on use - `SPEED` - Temporary speed boost on use - `LIGHTNING_STRIKE` - Summon lightning at target location - `EXPLOSION` - Create explosion at target location - `HEAL` - Heal the player ### Example: Custom Textured Weapon ```yaml items: ice_sword: name: "&bFrostbite Blade" material: "DIAMOND_SWORD" price: 500.0 permission: "crosscosmetics.item.icesword" free: false abilities: - "SLOWNESS" lore: - "&7Forged from eternal ice" - "&7Slows enemies on hit" enchantments: SHARPNESS: 5 KNOCKBACK: 2 UNBREAKING: 3 custom-model-data: 25 cooldown: 15 ``` ## Adding Cosmetic Effects Cosmetics are configured in `cosmetics.yml`. These are visual effects like particle trails. ### Basic Cosmetic Configuration ```yaml cosmetics: flame_trail: name: "&cFlame Trail" type: "PARTICLE" material: "BLAZE_POWDER" price: 150.0 permission: "crosscosmetics.cosmetic.flame" free: false lore: - "&7Leaves a trail of flames" - "&7behind you as you walk" ``` ### Cosmetic Types - `PARTICLE` - Particle effects that follow the player ## Adding Custom Skins Skins are configured in `skins.yml`. Only works for Java Edition players. ### Basic Skin Configuration ```yaml skins: pirate_skin: name: "&6Pirate Skin" texture-url: "https://textures.minecraft.net/texture/7f9bc035cdc80f1ab5e1198f29e7b87e24583b8de8b7b3ad8db728bbd3e382a6" price: 200.0 permission: "crosscosmetics.skin.pirate" free: false ``` ### Getting Texture URLs 1. Go to [MineSkin](https://mineskin.org/) or [NameMC](https://namemc.com/) 2. Upload your skin or find an existing one 3. Copy the texture URL from the skin's data 4. Paste it in the `texture-url` field ## Using Custom Model Data (Textures) To add custom textures to armor and items, you need to create a resource pack. ### Step 1: Create Resource Pack Structure ``` MyResourcePack/ ├── pack.mcmeta └── assets/ └── minecraft/ └── models/ └── item/ ├── diamond_sword.json ├── diamond_helmet.json ├── diamond_chestplate.json ├── diamond_leggings.json └── diamond_boots.json ``` ### Step 2: Create pack.mcmeta ```json { "pack": { "pack_format": 15, "description": "CrossCosmeticsPlus Textures" } } ``` Pack format versions: - 1.20.x - 15 - 1.19.4 - 13 - 1.19.x - 9 - 1.18.x - 8 ### Step 3: Configure Item Models Example `diamond_sword.json` with custom model data: ```json { "parent": "item/handheld", "textures": { "layer0": "item/diamond_sword" }, "overrides": [ { "predicate": { "custom_model_data": 10 }, "model": "item/lightning_staff" }, { "predicate": { "custom_model_data": 25 }, "model": "item/ice_sword" } ] } ``` ### Step 4: Create Custom Model Files Create `lightning_staff.json`: ```json { "parent": "item/handheld", "textures": { "layer0": "item/custom/lightning_staff" } } ``` ### Step 5: Add Textures Place your custom texture PNG files in: ``` assets/minecraft/textures/item/custom/ ├── lightning_staff.png └── ice_sword.png ``` ### Step 6: Armor Textures For armor, you need both model files AND texture files. Example `diamond_helmet.json`: ```json { "parent": "item/generated", "textures": { "layer0": "item/diamond_helmet" }, "overrides": [ { "predicate": { "custom_model_data": 100 }, "model": "item/emerald_helmet" } ] } ``` Armor texture layers go in: ``` assets/minecraft/textures/models/armor/ ├── emerald_layer_1.png (helmet, chestplate, boots) └── emerald_layer_2.png (leggings) ``` ### Step 7: Matching Custom Model Data The `custom-model-data` value in your config files MUST match the `custom_model_data` predicate in your resource pack. **In armor.yml:** ```yaml custom-model-data: 100 ``` **In resource pack JSON:** ```json "predicate": { "custom_model_data": 100 } ``` ### Step 8: Package and Distribute 1. Zip the resource pack folder (select contents, not the folder itself) 2. Upload to a file host or your server's web directory 3. Configure in server.properties: ```properties resource-pack=https://yoursite.com/pack.zip resource-pack-sha1= require-resource-pack=true ``` ### Step 9: Testing Custom Textures 1. Start server with resource pack configured 2. Join server and accept resource pack 3. Run `/cosmeticadmin give armor emerald_warrior` 4. Equip the armor and verify textures appear ## Economy Integration The plugin integrates with Vault for economy features. ### Required Setup 1. Install [Vault](https://www.spigotmc.org/resources/vault.34315/) 2. Install an economy plugin (EssentialsX, CMI, etc.) 3. Restart server 4. Enable economy in `config.yml`: ```yaml economy: enabled: true currency-symbol: '$' ``` ### Free Items To make specific items free: ```yaml armor: starter_set: free: true ``` Or grant permission: `crosscosmetics.free` (makes everything free) ## Bedrock Edition Support The plugin supports Bedrock players through Floodgate/Geyser. ### Required Setup 1. Install [Floodgate](https://geysermc.org/download#floodgate) 2. Install [Geyser](https://geysermc.org/download) 3. Restart server ### Bedrock Features - **Form-based UI** - Native Bedrock forms instead of chest GUIs - **Skin Support** - Limited (Bedrock uses Microsoft account skins) - **Cosmetics** - Full support for armor, items, and effects ### Configuration ```yaml bedrock: enable-forms: true skin-change-enabled: false ``` **Note:** Skin changes don't work well on Bedrock due to platform limitations. ## Examples ### Complete Custom Armor Set **1. Add to armor.yml:** ```yaml armor: shadow_assassin: name: "&8Shadow Assassin Set" helmet: "NETHERITE_HELMET" chestplate: "NETHERITE_CHESTPLATE" leggings: "NETHERITE_LEGGINGS" boots: "NETHERITE_BOOTS" price: 5000.0 permission: "crosscosmetics.armor.shadow" free: false abilities: - "NIGHT_VISION" - "SPEED_BOOST" - "INVISIBILITY" custom-model-data: 200 ``` **2. Create resource pack overrides for each piece (e.g., netherite_helmet.json):** ```json { "parent": "item/generated", "textures": { "layer0": "item/netherite_helmet" }, "overrides": [ { "predicate": { "custom_model_data": 200 }, "model": "item/shadow_helmet" } ] } ``` **3. Create custom model (shadow_helmet.json):** ```json { "parent": "item/generated", "textures": { "layer0": "item/custom/shadow_helmet" } } ``` **4. Add textures:** - `assets/minecraft/textures/item/custom/shadow_helmet.png` - `assets/minecraft/textures/models/armor/shadow_layer_1.png` - `assets/minecraft/textures/models/armor/shadow_layer_2.png` **5. Give to player:** ``` /cosmeticadmin give PlayerName armor shadow_assassin ``` ### Complete Custom Item **1. Add to items.yml:** ```yaml items: void_wand: name: "&5Void Wand" material: "STICK" price: 1200.0 permission: "crosscosmetics.item.voidwand" free: false abilities: - "EXPLOSION" lore: - "&7Harness the power of the void" - "&7Right-click to unleash destruction" - "" - "&dCooldown: 45 seconds" enchantments: KNOCKBACK: 3 UNBREAKING: 3 custom-model-data: 50 cooldown: 45 ``` **2. Add to resource pack (stick.json):** ```json { "parent": "item/handheld", "textures": { "layer0": "item/stick" }, "overrides": [ { "predicate": { "custom_model_data": 50 }, "model": "item/void_wand" } ] } ``` **3. Give to player:** ``` /cosmeticadmin give PlayerName item void_wand ``` ## Troubleshooting ### Textures Not Showing 1. **Verify Custom Model Data matches** between config and resource pack 2. **Check resource pack is loaded** - F3 + T to reload 3. **Verify JSON syntax** - Use a JSON validator 4. **Check file paths** - All paths are case-sensitive 5. **Ensure pack format** matches your Minecraft version ### Economy Not Working 1. Verify Vault is installed: `/plugins` 2. Verify economy plugin is installed (EssentialsX, CMI, etc.) 3. Check economy is enabled in `config.yml` 4. Check console for economy errors on startup ### Abilities Not Working 1. Verify ability names match available abilities 2. For armor abilities, full set must be worn 3. Check console for errors when using abilities 4. Verify ability cooldowns have expired ### Permissions Not Working 1. Check permission plugin is installed (LuckPerms, etc.) 2. Verify permissions are granted: `/lp user permission check ` 3. Check for wildcard permissions overriding specific ones 4. Restart server after permission changes ## Support For issues, questions, or feature requests, please contact the plugin author or check the plugin documentation. ## Credits - **Author:** UltraElite90 - **XSeries:** For cross-version compatibility - **Vault:** For economy integration - **Floodgate/Geyser:** For Bedrock support