ChamoItemSkins

ChamoItemSkins

ChamoItemSkins is a Minecraft skin plugin built for Paper 26.1.2 and Folia. It allows players to unlock and apply skins to their items.

Features

• Folia: Why not?
• Skin Notes: Give players "Skin Notes" that they can use to unlock a skin.
• PlaceholderAPI: Placeholders for active skins, ownership status, and totals.
• Nexo Items Support Instead of vanilla textures, use Nexo Items
• HMCWarps Migration Migrate from HMCWarps to us

Requirements

• Java 25 or higher.
• Paper/Folia 26.1.2+.
• (Optional) PlaceholderAPI for placeholders.
• (Optional) Nexo for NexoItems support
• (Optional) HMCWarps for the migration

Installation

1. Download the latest ChamoItemSkins.jar.
2. Place it in your server's plugins/ folder.
3. Restart your server to generate the default configuration files.
4. Configure our plugin and enjoy!

Configuration

Keep in mind that our documentation has a more detailed guide, so we recommend checking that instead :D

• config.yml: Database settings, default Note item settings, selfpack hosting, filler gui items, rarities, etc.
• skins.yml: Define skins and bundles.
• guis\(gui): Edit a gui
• lang\(language code) Stores all the messages in the specified language

Example Skin (skins.yml)

skins:
  infernal_blade:
    id: "infernal_blade"
    name: "<gradient:red:dark_red>Infernal Blade"
    model-id: "chamoitemskins:infernal_blade"
    item-type: DIAMOND_SWORD
    enabled: true
    display-item:
      id: DIAMOND_SWORD
      name: "<gradient:red:dark_red>Infernal Blade"
      lore: [ "<gray>A blade forged in hellfire." ]
      glow: true

Example Bundle (skins.yml)

bundles:
  sky_bundle:
    id: sky_bundle
    name: "Sky Bundle"
    skins:
      - sky_meteor

Commands & Permissions

Player Commands

Admin Commands

Placeholders

Use these with PlaceholderAPI:

• %chamoitemskins_active_<MATERIAL>%: Returns the name of the active skin for the specified material.
• %chamoitemskins_owns_<skinId>%: Returns true or false if the player owns the skin.
• %chamoitemskins_total_owned%: Total number of skins owned by the player.
• %chamoitemskins_total_skins%: Total number of enabled skins available.

Developer API

Developers can hook into ChamoItemSkins' :api submodule.

Repository

The repository for the API can be accessed here:

maven {
    name = "chamosmpRepoReleases"
    url = uri("https://maven.chamosmp.net/releases")
}

compileOnly("net.chamosmp.chamoitemskins:api:version")

<repository>
  <id>chamosmp-repo-releases</id>
  <name>ChamoSMP Maven Repository</name>
  <url>https://maven.chamosmp.net/releases</url>
</repository>

<dependency>
  <groupId>net.chamosmp</groupId>
  <artifactId>ChamoParty</artifactId>
  <version>version</version>
</dependency>

maven {
    name "chamosmpRepoReleases"
    url "https://maven.chamosmp.net/releases"
}

implementation "net.chamosmp.chamoitemskins:api:version"

Events

• SkinEquipEvent: Fired when a player equips a skin.
• SkinUnequipEvent: Fired when a player unequips a skin.
• SkinGrantEvent: Fired when a player unlocks a skin via a Note or Admin command.
• SkinRevokeEvent: Fired when a skin is removed from a player.

Javadocs

Don't forget to see our Javadocs for more information

Accessing the API

ChamoItemSkinsApi api = Bukkit.getServicesManager().load(ChamoItemSkinsApi.class);
if(api != null){
    SkinService skinService = api.getSkinService();
    // Your logic here
}

Brought to you by SQD Studios. Keep in mind this is vibecoded to see how powerful (even though it isn't a valid excuse) it is. I've personally checked every file to maintain the quality. There aren't a lot of things (except unperformed code) that could go wrong right? If I have time, I may recode this as some people actually need it

All the assets are made by real humans, without any assistance of AI.

Credits:

• assets/ChamoItemSkins.png - Chamogelastos, made with Affinity (Project Files)
• assets/logo-icon.svg - Black and white convertion of assets/ChamoItemSkins.png to an svg
• assets/ChamoItemSkins ad.png - Chamogelastos, made with Affinity (Project Files)

Want to contribute assets yourself? DM me on discord (chamogelastos)

--