Dev Studio
The Dev Studio is the in-game editor. Everything it changes is written to the config files and broadcast to every online player instantly — no restart, usually no /gc reload.
Access
- Open
/wardrobe→ Dev Studio tab. - Requires a real server operator account, and the full server jar (the client-only jar has the Dev Studio stripped out).
gc.devalone gives you the admin controls inside the Tags and Party tabs, but not this panel.
The menu has Cosmetics, Effects, Cosmetics Types, Server Config, Slots, and Chat Tags (only shown if the server has LuckPerms — see Permissions).
Cosmetics page
A searchable grid with a type filter. Two create buttons:
- + Cosmetic — a new standard cosmetic (
new_cosmetic_XXXX). - + Armor — a new armor-based cosmetic bound to a real item (see Armor Cosmetics).
Click a cosmetic to open the editor. S saves, C duplicates it (<id>_copy, _copy2…), X deletes (with confirm), < goes back. Hover any of the four for a tooltip.
Editor sections
| Section | Fields |
|---|---|
| Identification | Main ID (file name), Icon Name, Model Texture, Display Name, Tooltip Description (extra MiniMessage lines shown under the name in the wardrobe), Slot, Type, Permission, Granted Permissions, Minecraft Tags. (Armor cosmetics show "Real Item" instead of the ID.) |
| Icon | Only for virtual cosmetics with no dedicated flat icon — frames the 3D model when it's used as its own wardrobe-grid icon. See Making Models. |
| Auto-Unlock | Unlock Permission / Unlock Tag — a player holding either one gets the cosmetic automatically, without a database row, and loses it the moment they no longer qualify. See Permissions. |
| 3D Models | One block per part — see below. |
| Variants | Optional. Alternative placements of the same model, each with its own effects too — see below. (virtual cosmetics only) |
| Status & Combat | Armor Points, Toughness, Max Durability, Auto-Feed. → Attributes |
| Backpack | Is Backpack?, Rows, Name. → Backpacks |
| Special Effects | Allows Flight?, Fly / Ground / Swim Speed, >> Select Effects (potion effects — these now also apply from armor cosmetics, see below), Effect Visual, Fly Particle, Shift Particle (plays only while sneaking). → Attributes, Particle Effects |
| Cobblemon Effects | >> Cobblemon Effects opens the Lure + Scanners editor (only shown if the server has Cobblemon). Every field has a hover tooltip. → Cobblemon Effects |
| Sounds | Idle / Walk / Fly / Shift sounds, each with volume + pitch, plus Sound Interval and Idle Sound Interval (ticks between repeats). → Sounds |
Granted Permissions and Minecraft Tags
Comma-separated lists. Every node in Granted Permissions and every tag in Minecraft Tags is applied to the player while the cosmetic is worn and its Permission gate passes, and removed the instant it's unequipped — the same mechanism Tags already use. This also works for armor cosmetics worn as the real item.
Editing a part
Each part in 3D Models has:
- Part N (Model/ID) — the flat icon / vanilla model name.
- Part N (GeckoLib Model ID) — a GeckoLib geometry name (takes priority when set).
- Part N: Exact Path — toggle: treat the two fields above as full relative paths instead of just file names.
>> Config Part N— opens the transform popup.+ Duplicate Part N— inserts an exact copy of the part right after it.X Remove Part N— deletes the part.+ Add Part— adds another part.
Armor cosmetics show a Part N: Anchor dropdown directly in the list (HEAD/BODY/RIGHT_ARM/LEFT_ARM/RIGHT_LEG/LEFT_LEG) — the real 3D armor model renders on that bone. A >> Split into N body parts button rebuilds the part list to match the armor slot (chestplate → torso + arms, leggings → torso + legs, boots → legs), each following its own bone.
Full explanation on Parts & Models, including the 3D gizmo (hold X, Y or Z and drag outside the panel to move / rotate / scale the selected part live).
The transform popup: gizmo tool (Move / Rotate / Scale), Anchor, Scale XYZ, Normal values (Offset / Rotation XYZ), and Sneak values (Shift Offset / Rotation XYZ, used while the player is sneaking).
Variants
A variant is an alternative placement of the cosmetic — same model, different position — and can also carry its own particle effects. Example: a scarf cosmetic with a neck variant and a waist variant.
+ Add Variantcreates one and opens its editor immediately;X Remove Variant Ndeletes it.- Each variant row has a Variant ID field (
[a-z0-9_], unique in the cosmetic). >> Config Variant Nopens the editor: Display Name (what players see in the picker), Slot (blank = inherit the base cosmetic's slot — only affects slot limits), Anchor, Offset / Rotation / Scale (with the live 3D gizmo and preview, same as a normal part), and an === EFFECTS === section — Effect Visual / Fly Particle / Shift Particle left empty inherit the base cosmetic's; filling in at least one gives the variant its own set instead.- If the base cosmetic has more than one Part (e.g. a two-part shoe pair, one per foot), an Editing Part field appears at the top of the popup — pick which of the base's Parts the fields below are currently repositioning. Each Part of the variant starts as a clone of the matching base Part (same model, same starting pose); switching between them never loses what you already tuned on the others.
- When a cosmetic has ≥1 variant, players clicking it in the wardrobe get a picker: Default (the base placement) + each variant. Only one variant (or Default) of a cosmetic can be worn at a time — they must unequip before switching.
- Variants are free — anyone who owns the cosmetic can use any variant.
- Don't add variants to a backpack cosmetic (all variants would share one backpack).
The gizmo toolbar
A cluster of on-screen buttons appears around the 3D preview whenever a Part or an Effect is selected — none of them need the sidebar panel to be open.
Left sidebar (next to the transform popup):
| Button | Does |
|---|---|
| S | Toggle the sneak preview, so you see the Sneak values in action. |
| Alpha slider | Fade the player's body (not the cosmetic) to see parts clearly. |
| C | Toggle whether the player's actually equipped cosmetics also show in the preview, alongside the one you're editing (on by default in the Effects page, off elsewhere). |
| P | Toggle particle visibility in your own preview (same setting as the Preview tab's toggle). |
| + / − | Only for GeckoLib parts: nudge the gizmo pivot (saved to gizmo_dev_config.json). |
| E | (Effects page only, editing a member of a group) Isolate — hide every other member of the group so only the one you're editing shows. |
Bottom-left corner: D — shows the gizmo's raw debug numbers (only while a part/effect is selected).
Center-right of the screen: three colour-coded buttons (X red, Y green, Z blue) — snap that axis's offset back to zero (or the Sneak offset, while previewing Sneak) in one click, instead of dragging the gizmo back by hand.
Bottom-right corner (part selected): ↔ mirror horizontally (flips scaleX), ↕ mirror vertically (flips scaleY), ↺ reset the part (offset/rotation back to 0, scale back to 1).
Top-right corner: Anim — cycles the live preview through AUTO → idle → walk → run → fly → swim → fall → sneak, forcing that animation state so you can check every clip without actually doing it in-game. GeckoLib parts only.
Undo / Redo
Ctrl+Z undoes, Ctrl+Shift+Z (or Ctrl+Y) redoes — works in the Cosmetics and Effects editors (not inside a group editor or the list view). Edits are coalesced: it only records a step once you pause for ~400 ms, so you don't have to undo one keystroke at a time.
Effects page
Create and edit particle effects and effect groups — simple bursts or geometric shapes (circle, helix, beam, pulse), with colour, presets, a live 3D preview and a 3D gizmo for the offsets. Has its own search bar and an All / Effects / Groups filter. See Particle Effects for the full field reference. Attach an effect (or group) to a cosmetic via Special Effects → Effect Visual / Fly Particle / Shift Particle.
Cosmetics Types page
Define accessory types — Type ID, Base Slot, Limit Per Player, Permission (and the gc.extratypeslot.* tier nodes). Types are how you cap "one necklace at a time" separately from the slot limit. See Slots & Types.
Slots page
The nine virtual slots are fixed — you can't rename, add or delete them. Edit only Default Limit and Permission (the base node for tier limits, /gc extraslot, etc.) per slot. See Slots & Types.
Chat Tags page
(Only visible if the server has LuckPerms.) A dedicated editor for the same catalog the wardrobe's Tags tab already lets gc.dev players edit — list every Tag (group Tags first, then custom ones), + New Tag, click one to edit Display Name / Description / Prefix / Permissions / Minecraft Tag. Group Tags can be edited but not deleted. See Tags.
Server Config page
Edits mainconfig.conf live: Auto Detect Models, MySQL settings, Force Resource Pack + Texture URL/ID/SHA1 (kept in sync with server.properties automatically), Effect Block Groups (LuckPerms groups whose cosmetics still show but grant nothing), the Lure HUD toggle, and the startup commands list. See Main Config.
Unsaved changes
Leaving an editor with pending edits shows a popup: Save, Don't Save, or Continue editing. Esc triggers the same prompt.
Testing without owning things
Turn on Dev Mode (the Dev: ON toggle in the equipped-slots drawer, or it auto-enables when an operator opens the Dev/Tags/Party tab). Every cosmetic and Tag becomes previewable without a /gc give.