Overview

MeltingWelcome is the panel that opens the first time somebody joins your server. Home, rules, wipe countdown, your socials, your kits and your VIP ranks, all in one place, all looking like something you paid for.

The part that makes it different is that you never touch the config file. Every colour, every word, every tab, every rule, every VIP package and every link is edited from an admin panel inside the game. You click EDIT in the header, change what you want, and it saves straight to disk. No reload, no restart, no FTP.

It ships with six tabs already filled in with placeholder content, so it looks finished the moment you drop it in. Swap the text for your own and you are done. If you want more tabs you add them in game and pick what each one renders.

There are no dependencies. The Kits tab reads the free Kits plugin from uMod if you have it and shows a tidy placeholder if you do not. ImageLibrary is not used at all, so there is nothing extra to install and nothing to re-import on wipe.

Features

• Six tabs out of the box: Home, Rules, Wipe, Social, Kits and VIP
• Unlimited extra tabs, created in game, each rendering whichever type you pick
• Full in game editor with nine sections, no config file editing at any point
• Seven built in themes, plus twenty individual colour slots you can set by hex
• Two and three colour background gradients, vertical or horizontal, with adjustable smoothness
• Rounded corners, frosted glass blur behind the panel, three blur strengths, adjustable background darkness
• Live wipe countdown that keeps ticking while a player is looking at it
• Five wipe schedule modes including Facepunch's first Thursday force wipe
• Blueprint wipe tracking worked out from your own wipe cycle
• Kits tab pulls straight from the Kits plugin with real in game item icons, cooldowns and use limits
• Kit redeeming that respects every check your Kits plugin performs
• VIP packages with prices, perks, a featured ribbon, and an owned badge for ranks the player already holds
• Live stat tiles and header chips: players online, sleepers, next wipe, server time
• Seventeen text tokens usable in any field, so the content keeps itself up to date
• Per tab permissions, so a staff only or VIP only tab is one field away
• Text size multiplier for players on large monitors
• Optional chat greeting on join, optional sound when the panel opens
• Panel can reopen itself for everybody after a wipe
• Every plugin message editable in the lang file
• API for other plugins
• No dependencies, Kits is optional, works on Oxide and Carbon

Permissions

oxide.grant group admin meltingwelcome.admin

The editor is strictly permission based. Being a server admin does not grant it on its own, because a moderator you trust to ban cheaters is not necessarily somebody you want rewriting your rules and your VIP prices. If you would rather all your admins have it, there is a setting for that. Until somebody holds the permission the plugin reminds you in console on load.

Any VIP package permission you name starting with meltingwelcome. is registered for you automatically, so meltingwelcome.vip.gold works without you creating it first.

Commands

The command list is configurable, so if /info clashes with another plugin you rename it or remove it. Everything else in the plugin is clicking. There is nothing else for your players to learn.

The tabs

Home

Your front page. A hero headline, up to five live stat tiles, a row of quick action buttons that can jump to another tab, print a link or run a command, and then as many content blocks underneath as you want.

Rules

Numbered sections with individual rules inside them. Add, reorder and delete both from the editor. Long rules wrap properly and alternating row shading keeps a long list readable.

Wipe

A large live countdown, the exact wipe date and time, and your blueprint wipe status. Five schedule modes:

Blueprint wipes are worked out from your cycle. Set how many map wipes there are between blueprint wipes plus an anchor date, and it keeps itself correct from then on. On force wipe mode the blueprint wipe follows the force wipe, because that is what Facepunch does.

Social

Cards for your Discord, Steam group, YouTube, store, anything. Each one has a name, handle, description and its own brand colour, plus a button that prints the link into the player's chat and F1 console so they can copy it.

Kits

Reads your Kits plugin live. Every kit becomes a card showing its real item icons, description, cooldown and use count, with a status badge: ready, on cooldown with the time remaining, locked, or used up. Clicking a card opens the full contents grid with stack amounts. Show every kit automatically or curate a list, hide the ones you do not want, sort by name or cooldown, and choose how many fit per row.

VIP

Your rank packages. Price, duration, tagline, perk list, brand colour, a featured ribbon for the one you want to push, and an owned badge that appears automatically for ranks the player already holds. Each package's button can print a store link, run a command, or do nothing at all if you only want a price list.

Custom tabs

Render content blocks, six kinds: heading, paragraph, bullet list, card, highlighted note and divider. Enough to build whatever your server needs.

The in game editor

Click EDIT in the header. Nine sections:

Everything writes to the config file the moment you change it, so nothing is lost if the server goes down mid edit. Text fields save quietly as you tab between them instead of stealing your cursor, and there is an APPLY and PREVIEW button for when you want to see colour changes land.

Text tokens

Usable in any text field. Hero titles, stat tiles, rules, schedule lines, chat greeting, content blocks, anywhere.

So a stat tile with the value {online}/{max} keeps itself correct forever, and a hero title of WELCOME TO {server} works on any server you install it on without editing.

Kit redeeming, and why it is safe

MeltingWelcome does not call it. Redeeming runs your server's own /kit command on the player's behalf, so every check your Kits plugin performs still runs, including cost and any custom rules you have set up.

If you want the direct call anyway it is in the config, clearly labelled. The safe option is the default.

Install

1. Drop MeltingWelcome.cs into oxide/plugins
2. Grant yourself the editor with oxide.grant group admin meltingwelcome.admin
3. Type /welcome in game and click EDIT

The config generates itself with placeholder content already written, so the panel looks finished from the very first load. Replace the text with your own and you are done.

Optional: install the free Kits plugin and the Kits tab fills itself in automatically.

Developer API

[PluginReference] private Plugin MeltingWelcome;

MeltingWelcome?.Call("OpenWelcomePanel", player);
MeltingWelcome?.Call("OpenWelcomePanel", player, "rules");
MeltingWelcome?.Call("CloseWelcomePanel", player);

Compatibility

Oxide and Carbon. No dependencies. Kits is optional. ImageLibrary is not used.

Every visual effect is a config toggle, so if anything renders oddly on an unusual build you switch it off and get clean flat panels instead.