Open Cosmetics

Open Cosmetics

Open Cosmetics e' il modulo Paper dedicato ai cosmetici arma.

Obiettivo

Gestire personalizzazioni visuali e sonore senza duplicare la logica armi.

Supporta:

• LED;
• colori;
• skin;
• gettoni consumabili;
• editor;
• banco cosmetico;
• stazioni nel mondo;
• decorazione nome item;
• suoni personalizzati per skin;
• bridge opzionale verso Open Weapons.

Stato

Open Cosmetics e' un plugin standalone.

Se Open Weapons non registra il bridge, Open Cosmetics si abilita comunque. In quel caso GUI, config e token restano disponibili, ma non puo' applicare cosmetici a item arma finche' un modulo armi non fornisce il bridge.

Dipendenze

Dipendenza runtime opzionale:

softdepend:
  - OpenWeapons

Comandi

/opencosmetics editor
/opencosmetics gui [giocatore]
/opencosmetics token <led|color> <id> [quantita'] [giocatore]
/opencosmetics station <create|remove|list> [id]
/opencosmetics color <#RRGGBB|none>
/opencosmetics skin <skin-id|none> [giocatore]
/opencosmetics skins [weapon-id]
/opencosmetics clear <led|color|skin|all>

Alias:

/weaponcosmetic

Permessi

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

Alias compatibili:

• openrp.weapons.cosmetic.use
• openrp.weapons.cosmetic.admin

Configurazione

File:

plugins/OpenCosmetics/weapon_cosmetics.yml

Sezioni principali:

• weapons: abilita/disabilita supporto per arma e tipo cosmetico;
• leds: definisce LED disponibili e token;
• colors: definisce finiture colore preconfigurate;
• skins: definisce skin per arma, suffissi nome, gradienti e suoni.

Armi supportate nella config iniziale

• m4a1
• ak_47
• ppk
• mp5
• remington_870

LED iniziali

• usa
• italy
• france
• anime
• pacman

Colori iniziali

• red
• blue
• green
• white
• black

I colori possono anche essere applicati da comando con formato #RRGGBB.

Skin iniziali

Skin comuni:

• gold-reserve
• sugarline-bakery

Skin specifica M4A1:

• royal-masquerade

Le skin possono definire:

• display-name;
• name-suffix;
• suffix-gradient;
• sound-fire;
• sound-hit;
• sound-headshot;
• sound-reload.

Bridge con Open Weapons

Open Cosmetics pubblica:

OpenCosmeticsApi

Open Weapons registra:

OpenCosmeticsWeaponBridge

Il bridge permette a Open Cosmetics di:

• riconoscere se un item e' un'arma;
• ottenere l'id arma;
• chiedere il refresh del model data;
• mantenere coerenti skin, LED, colore, ottica, grip e caricatore.

Resource pack

Gli asset cosmetici sono in:

open-cosmetics/assets/resource-pack/

Lo zip viene generato in:

target/resource-packs/open-cosmetics-resource-pack.zip

Test manuale consigliato

1. Installa Open Cosmetics.
2. Installa Open Weapons o un modulo che registra OpenCosmeticsWeaponBridge.
3. Dai un token:

/opencosmetics token led italy 1 <player>

4. Apri l'editor:

/opencosmetics editor

5. Applica LED/colore/skin.
6. Verifica nome item, model data e suoni skin.