Installation

Requirements

• A Minecraft server running Paper, Purpur, Folia or Spigot (1.18 or newer).
• Java 17 or newer— same as Paper's baseline since 1.18.
• A StarChat license. Buy on BuiltByBit or start a 7-day free trial.

1 · Drop in the JAR

Stop your server, then copy StarChat-<version>.jar into your plugins/ folder. There is no separate Folia build — the same JAR runs everywhere.

2 · First boot

Start the server. StarChat creates the full config tree on first run, warns about the missing license key, then disables itself. That's expected.

[StarChat] Generating default configs in plugins/StarChat/...
[StarChat] No license key found. Set one in settings.yml and restart.
[StarChat] Plugin disabled.

3 · Paste your license key

Open plugins/StarChat/settings.yml and paste the key from your dashboard or your BuiltByBit confirmation email:

# ── License Key ──
# Your unique license key. Get it from the StarChat Discord
# using the !licencia command after verifying your purchase.
# The plugin will not start without a valid license.
license-key: 'SC-XXXX-XXXX-XXXX-XXXX'

4 · Restart and verify

Stop and start the server again — /reload is not enough on first boot because we need a clean classloader. You should see:

[StarChat] License verified — bound to 1.2.3.4
[StarChat] FoliaScheduler ready (mode: Folia | Paper | Bukkit).
[StarChat] Loaded 6 modules in 142ms.
[StarChat] Ready.

What to do next

• Configuration overview — see how the YAML files fit together.
• Chat formats — wire your LuckPerms groups to per-rank prefixes.
• Chat filter — tune the default rules to your community.
• Nebula AI — ask configuration questions and get ready-to-paste YAML.