Open Cosmetics

Standalone

Il modulo Paper dedicato ai cosmetici arma: gestisce personalizzazioni visuali e sonore — LED, colori, skin con suoni dedicati, gettoni consumabili, editor, banco e stazioni nel mondo — senza duplicare la logica del combat.

Scarica il JAR Sorgente Wiki

Namespacedev.openrp.cosmetics

Comando/opencosmetics · /weaponcosmetic

Dipendenzenessuna obbligatoria

Soft-dependOpen Weapons

APIOpenCosmeticsApi

Cosa fa

Open Cosmetics si abilita anche senza Open Weapons: GUI, config e token restano disponibili, ma non può applicare cosmetici alle armi finché un modulo armi non registra il bridge.

LEDEffetti luminosi applicati all'arma come cosmetico.

Colori customFiniture in formato #RRGGBB, anche da comando.

Skin armaModelli alternativi per le armi supportate.

Gettoni consumabiliToken usa-e-applica per LED e colori.

Editor e banco cosmeticoInterfacce per comporre e applicare cosmetici.

Stazioni cosmetichePostazioni piazzabili nel mondo per i cosmetici.

Decorazione nome itemDisplay name e suffissi con gradienti sull'arma.

Suoni personalizzatiAudio dedicati per skin: fire, hit, headshot e reload.

Comandi

Tutti i comandi sono accessibili anche tramite l'alias /weaponcosmetic.

Comando	Funzione
`/opencosmetics editor`	Apre l'editor.
`/opencosmetics gui [giocatore]`	Apre la GUI.
`/opencosmetics token <led\|color> <id> [quantità] [giocatore]`	Crea / dà gettoni.
`/opencosmetics station <create\|remove\|list> [id]`	Gestisce le stazioni.
`/opencosmetics color <#RRGGBB\|none>`	Applica un colore.
`/opencosmetics skin <skin-id\|none> [giocatore]`	Applica una skin.
`/opencosmetics skins [weapon-id]`	Elenca le skin.
`/opencosmetics clear <led\|color\|skin\|all>`	Rimuove cosmetici.

Permessi

Sono accettati anche gli alias compatibili openrp.weapons.cosmetic.use e openrp.weapons.cosmetic.admin.

Permesso	Descrizione	Default
`openrp.cosmetics.use`	Usa editor / stazioni / cosmetici base.	true
`openrp.cosmetics.admin`	Crea token, stazioni e applica skin da comando.	op

Contenuti iniziali

Set di cosmetici incluso di default, pronto da estendere. Tutto è guidato da config.

Armi supportate

m4a1ak_47ppkmp5remington_870

LED

usaitalyfranceanimepacman

Colori

redbluegreenwhiteblack

Oltre ai colori predefiniti è possibile applicare qualsiasi #RRGGBB da comando.

Skin

gold-reservesugarline-bakeryroyal-masquerade (m4a1)

Le skin possono definire: display-name, name-suffix, suffix-gradient, sound-fire, sound-hit, sound-headshot e sound-reload.

Configurazione

La configurazione vive nel file plugins/OpenCosmetics/weapon_cosmetics.yml, organizzato nelle sezioni weapons, leds, colors e skins.

config · weapon_cosmetics.yml

leds:
  italy:
    display-name: "LED Italia"
    token-material: PAPER
    token-custom-model-data: 9011
colors:
  red:
    display-name: "Finitura rossa"
    hex: "#B02E26"
skins:
  m4a1:
    royal-masquerade:
      display-name: "M4A1 Riserva Aurum"
      suffix-gradient: ["#A96F00", "#FFD76B"]
      sound-fire: "weapons.m4a1.skin.fire"

Bridge con Open Weapons

Open Cosmetics pubblica OpenCosmeticsApi; Open Weapons implementa e registra OpenCosmeticsWeaponBridge via Bukkit Services. Il bridge permette di:

Riconoscere se un item è un'arma
Ottenere l'id arma
Chiedere il refresh del model data
Mantenere coerenti skin / LED / colore / ottica / grip / caricatore

Resource pack

Gli asset cosmetici in formato aperto stanno in open-cosmetics/assets/resource-pack/. La build genera lo zip Minecraft-ready in target/resource-packs/open-cosmetics-resource-pack.zip.

bash · genera il resource pack

bash scripts/build-resource-packs.sh
# output: target/resource-packs/open-cosmetics-resource-pack.zip