06 Configuration

Configuration

MCPSkins splits its settings into two separate config files, following NeoForge's usual client/server split — and the distinction matters more than usual here, because it controls trust, not just preference.

• Client config (mcpskins-client.toml, one per install) — purely local UI preferences: button position, toast behavior, carousel sizing. Never synced, never trusted by the server, changing it can't give you or anyone else anything they shouldn't have. Editable in-game via the mod's entry in the mods list ("Config" button), which opens a full settings screen — including a drag-to-place picker for the refit button's position — so hand-editing the TOML is entirely optional.
• Server config (per-world, under world/serverconfig/) — the authoritative rules: fusion cost, permission levels, whether locked skins can even be previewed. This is what actually gates what players can do; the client config can't override any of it.

Client settings

Setting	Default	What it does
refit_toggle_button.enabled	true	Show/hide the skin-mode toggle button on TACZ's refit screen entirely.
refit_toggle_button.anchor	TOP_RIGHT	Which screen corner the offsets below are measured from (TOP_LEFT / TOP_RIGHT / BOTTOM_LEFT / BOTTOM_RIGHT).
refit_toggle_button.offsetX / offsetY	120 / 10	Pixel offset from the chosen corner. The defaults tuck the button just to the left of TACZ's own attachment row.
refit_toggle_button.size	18	Button size in pixels (12–32).
refit_toggle_button.showTooltip	true	Show the hover label under the button.
toast.enabled	true	Show a small confirmation toast when a skin is actually applied (not on a locked-skin preview).
toast.durationMs	2200	How long the toast stays visible, in milliseconds (500–10000).
carousel.height	96	Height in pixels of the refit-screen skin carousel panel.
carousel.slotSize	44	Base size in pixels of one carousel slot.
carousel.slotSpacing	60	Horizontal spacing between carousel slots.

Tip. Rather than hand-typing pixel offsets, use the in-game "Reposition" button in the mod's config screen — it opens a live picker where you drag the button to where you want it, and it writes the anchor/offset values for you.

Server settings

These live in the world's server config and apply to everyone on that server, regardless of any individual's client settings.

Setting	Default	What it does
fusion.enabled	true	Master switch for the shift-right-click fuse mechanic. Set false to disable it entirely.
fusion.cost	3	How many same-rarity unlock items are consumed per fuse roll (2–10).
access.allowLockedSkinPreview	true	Whether the refit-screen carousel and Armory allow the client-only visual preview of a skin the player doesn't own. Turning this off means players can only browse locked skins' names/rarity/description, without the "try it on" preview.
access.equipBypassPermissionLevel	2	Minimum permission level that can equip any skin regardless of ownership — useful for staff/testers who want to try skins without running unlock commands on themselves first.
access.adminCommandPermissionLevel	4	Minimum permission level required to use any /mcpskins give//mcpskins take subcommand (2–4).

Note. Both permission-level settings gate behavior, not visibility — a player below equipBypassPermissionLevel can still see and preview every skin (subject to allowLockedSkinPreview), they just can't make an unowned equip stick.

Where the files actually live

• Client: the usual per-instance NeoForge client config location, and it loads early enough that the mods-list "Config" screen can open before a world is even loaded — settings there always apply to your next screen open.
• Server: world/serverconfig/, meaning it's per-world, not global to the server jar. If you run multiple worlds/servers off the same install, each needs its own server config edited (or copied) separately.

Next: if something isn't behaving the way this wiki says it should, or you're curious what's actually happening under the hood — Troubleshooting & Internals.