Complete reference for installing, configuring, and extending FCore on your Minecraft server.

Installation

1. 1
   Purchase FCore

   Buy FCore on SpigotMC. After purchase you will receive the plugin JAR. Keep your SpigotMC order ID — you need it for license activation.
2. 2
   Request your license key

   Join the Kraken Studios Discord and open a ticket in the #license-request channel. Provide your SpigotMC username and order ID. You will receive your key within 24 hours.
3. 3
   Drop the JAR into /plugins

   Copy FCore-2.0.0.jar (or FCore-2.0.0-PROTECTED.jar for the obfuscated build) into your server's /plugins folder.
4. 4
   Start the server once

   Start the server. FCore generates all config files in /plugins/FCore/. A warning about a missing license is expected on the first boot.
5. 5
   Enter your license key

   Open /plugins/FCore/config.yml, find the license.key field, and paste your key. Save and restart.
6. 6
   Configure and enjoy

   All systems are active. Continue with the configuration sections below to tune each module to your server.

License Setup

FCore verifies your license on every startup. Without a valid key the plugin will not enable.

config.yml — license field

license:
  key: "YOUR-LICENSE-KEY-HERE"

Getting a license

Join discord.com/invite/f3ut3gWxgB → open a ticket → share your SpigotMC order ID → receive your key.

Requirements

config.yml

Main plugin configuration. Controls global toggles, module flags, chat, spawn delay and the license key.

license:
  key: "YOUR-KEY"

lobby-mode: true

chat:
  enabled: true
  format: "{prefix} {player}: {message}"
  anti-swear: true
  anti-ip: true

spawn:
  delay: 3
  auto-tp-on-join: true

modules:
  economy: true
  artilugios: true
  minions: true
  clearlag: true
  pvp-mode: false
  double-jump: true

database.yml

Database connection. FCore supports MySQL and SQLite. SQLite is used automatically if MySQL is disabled or unreachable.

mysql:
  enabled: true
  host: "localhost"
  port: 3306
  database: "fcore"
  username: "root"
  password: "your_password"

pool:
  min-connections: 16
  max-connections: 64
  connection-timeout: 30000

tables:
  players:
    name: ic_players
  economy:
    name: ic_economy
  stats:
    name: ic_stats
  punishments:
    name: ic_punishments

messages_es.yml

All player-facing strings. Supports hex colors with &#RRGGBB and standard Bukkit color codes.

prefix: "&#4a9effFCore &8»&r"

economy:
  balance: "{prefix} &7Balance: &a${amount}"
  insufficient: "{prefix} &cInsufficient funds."
  pay-sent: "{prefix} &7Sent &a${amount}&7 to &f{target}."

teleport:
  teleporting: "{prefix} &7Teleporting in &e{seconds}s..."
  cancelled: "{prefix} &cCancelled — you moved."

lobbyprotection.yml

Individual toggle for every lobby protection rule. Changes apply after /fcore reload.

enabled: true
bypass-permission: fcore.lobby.bypass

player:
  no-hunger: true
  no-fall-damage: true
  no-pvp: true
  auto-heal: true

blocks:
  no-break: true
  no-place: true

world:
  no-mob-spawning: true
  fixed-time: 6000

commandsblocked.yml

Command whitelist. By default every command is blocked for players unless listed in allowed-commands.

enabled: true
blocked-message: "&cNo access to this command."
block-worldedit: true   # No bypass

allowed-commands:
  enabled: true
  commands:
    - spawn
    - warp
    - tpa
    - pay
    - bal

console-only:
  enabled: true
  commands:
    - op
    - stop
    - plugins

menus/*.yml

YAML-defined GUI inventory menus. Create any number of menus without touching Java code.

title: "&8» &bServer Menu"
rows: 3

items:
  spawn-btn:
    slot: 13
    material: COMPASS
    name: "&aGo to Spawn"
    lore:
      - "&7Click to teleport"
    actions:
      left-click:
        - "[COMMAND] spawn"

Economy Module

Built-in economy with a native Vault provider. All balances are stored in the database.

Artilugios (Cosmetics)

Self-contained cosmetics subsystem. Players unlock cosmetic effects, chat colors, join messages and more. Definitions live in /plugins/FCore/artilugios/*.yml.

Floating Minions

Custom ArmorStands that float above the player with particle effects. Each type has its own particle style and permission.

/minion spawn <guerrero|mago|ninja|angel>
/minion remove
/minion list

Lobby Protection

Every rule is independently togglable from lobbyprotection.yml and applied with /fcore reload.

Teleportation

Full teleport suite with cooldowns, delay timers (cancelled on movement) and a complete TPA request flow.

Advanced Chat

Chat formatting, moderation filters and interactive clickable elements.

Command Blocker

Triple-layer filtering. Commands outside the whitelist are blocked at execution, removed from the client command list on join, and stripped from tab-complete in real-time.

/blockedcmds add <cmd>      Add to whitelist
/blockedcmds remove <cmd>   Remove from whitelist
/blockedcmds list            View whitelist
/blockedcmds reload          Reload from file
/blockedcmds check <player> See what a player can use

ClearLag

Automatic item entity cleanup with countdown warnings.

/clearlag           Show time until next clear
/clearlag clear     Force immediate cleanup   (fcore.clearlag.now)
/clearlag reload    Reload config             (fcore.clearlag.reload)

Commands Reference

Permissions

PlaceholderAPI

All placeholders use the %fcore_*% namespace. PlaceholderAPI must be installed.

FAQ

The plugin doesn't start — "License not found"

Open /plugins/FCore/config.yml and enter your license key in license.key. If you don't have a key yet, join the Discord and open a ticket.

Economy isn't working in other plugins (shops, jobs…)

Make sure Vault is installed. FCore registers itself as a Vault economy provider — any Vault-compatible plugin picks it up automatically.

Players can still use blocked commands after /blockedcmds add

Run /blockedcmds reload. Also verify the player doesn't have fcore.bypass.commandblocker.

Can I use FCore on a multi-server network?

Yes. Use MySQL so all servers share the same database. The Artilugios sync system uses BungeeCord plugin messaging channels. Each server needs its own FCore install and license key.

How do I build the obfuscated JAR?

mvn clean package -Pprotected

Output: target/FCore-2.0.0-PROTECTED.jar

I need help or found a bug

Open a support ticket in the Kraken Studios Discord. Include your server version, FCore version and the full console error.