CommandFoundry

CommandFoundry

Native Paper commands for teleports, homes, warps, kits, messaging, moderation, staff tools, and server utility.

CommandFoundry is a Paper command suite for servers that want common player and staff commands with native CommandFoundry storage, permissions, events, and configuration under the commandfoundry.* namespace.

It provides a broad utility command surface with explicit permissions, safe defaults, audit records, and storage support.

Features

• Spawn commands.
• Global and per-world spawn records.
• Homes with configurable limits and name validation.
• Warps with optional per-warp permissions.
• Teleport requests.
• /back support for deaths, CommandFoundry teleports, and meaningful external teleports.
• Random teleport with safe landing search.
• Village scan utility for staff testing.
• Kits with item rewards, command rewards, cooldowns, one-time use support, and admin reset tools.
• Private messaging, replies, ignore lists, mail, and message toggles.
• MOTD, rules, info pages, and custom text.
• AFK, nickname, realname, seen, near, playtime, position, compass, and depth utilities.
• Vanish, fly, speed, god, heal, feed, repair, hat, workbench, anvil, trash, and workstation commands.
• Staff inventory tools such as /invsee, /enderchest, /clearinventory, and /unlimited.
• Moderation commands for mute, warn, jail, unjail, freeze, unfreeze, kick, ban, pardon, and unban IP.
• Staff spy tools for private messages and commands.
• Staff teleport tools including /tphere, /tpall, /tpaall, /tpo, /tpohere, /tpoffline, /tppos, /top, /jump, /world, and /tptoggle.
• Personal time and personal weather commands.
• World and item utility commands.
• Guarded /cf subcommands for high-risk vanilla-sensitive operations.
• Compatibility aliases such as /tpacancel, /tpr, and /disposal.
• Config module toggles for command groups.
• Bukkit events for homes, warps, teleports, kits, punishments, vanish, and audit activity.
• Bukkit service API for other plugins.
• YAML, SQLite, MySQL, and MariaDB storage.
• SQLite storage by default.

Teleports

CommandFoundry includes player-facing and staff-facing teleport workflows.

Player teleport commands include:

• /spawn
• /home [name]
• /sethome [name]
• /delhome <name>
• /homes
• /warp <name>
• /warps
• /tpa <player>
• /tpahere <player>
• /tpaccept [player]
• /tpdeny [player]
• /tpcancel
• /back
• /rtp

Teleport behaviour is configurable:

• Warmup ticks.
• Cooldowns.
• Request timeout.
• Cancel on move.
• Cancel on damage.
• Cross-world teleports.
• Cross-dimension teleports.
• Death /back.
• Safe landing scan radius.
• Random teleport radius.
• Random teleport attempts.
• Ignored /back worlds.

/back locations are persisted after successful teleports, so restarts and rejoins do not wipe recent return points. CommandFoundry also records meaningful external plugin or command teleports without taking over every small movement.

Transient worlds such as CrimeReconstruction are ignored by default so players do not get trapped by stale /back destinations.

Homes, Warps, And Spawn

CommandFoundry stores homes, warps, and spawn records in its own storage.

Supported workflows include:

• Player homes.
• Configurable maximum homes.
• Home rename and delete.
• Global spawn.
• Per-world spawn.
• Spawn deletion through /cf delspawn.
• Public warps.
• Permission-gated warps.
• Warp information.
• Warp creation and deletion.

Name patterns for homes and warps are configurable.

Kits

CommandFoundry kits can include item payloads and command rewards.

Kit features include:

• /kit [name]
• /kits
• /showkit <kit>
• /kitreset <player> [kit|all]
• Default kit cooldown.
• Per-kit cooldown storage.
• One-time kit support.
• Kit admin permissions.
• Persistent cooldown tracking.

Messaging And Chat Utilities

CommandFoundry includes basic server communication tools:

• /msg <player> <message>
• /reply <message>
• /r <message>
• /ignore <player>
• /mail read|send|clear
• /rtoggle
• /broadcast <message>
• /broadcastworld [world] <message>
• /helpop <message>
• /socialspy
• /commandspy
• /motd
• /rules
• /info [key]
• /customtext <key>

Secret authentication commands are blocklisted from spy output by default, including common login, register, password, 2FA, email, captcha, and unregister command forms.

Staff And Utility Commands

CommandFoundry includes a broad set of staff and utility commands:

• /vanish
• /invsee <player>
• /enderchest [player]
• /fly [player]
• /speed fly|movement <amount>
• /god [player]
• /heal [player]
• /feed [player]
• /repair [all]
• /hat
• /clearinventory [player]
• /condense
• /ext [player]
• /firework [player]
• /gc
• /getpos [player]
• /itemdb [material]
• /more
• /playtime [player]
• /ptime <reset|day|night|ticks> [player]
• /pweather <clear|rain|reset> [player]
• /rest [player]
• /skull <player>
• /unlimited
• /whois <player>

Workstation commands include:

• /workbench
• /anvil
• /cartographytable
• /grindstone
• /loom
• /smithingtable
• /stonecutter
• /trash

Moderation

Moderation tools include:

• /mute <player> [duration] [reason]
• /warn <player> [reason]
• /jail <player> <jail> [duration] [reason]
• /unjail <player>
• /jailedplayers
• /deljail <name>
• /freeze <player> [duration] [reason]
• /unfreeze <player>
• /sudo <player> /<command>
• /unbanip <address>

High-risk or vanilla-conflicting moderation and admin actions are exposed through guarded /cf subcommands instead of replacing every vanilla command directly.

Examples include:

• /cf kick
• /cf ban
• /cf pardon
• /cf tp
• /cf gamemode
• /cf time
• /cf weather
• /cf give
• /cf item
• /cf enchant
• /cf potion
• /cf remove
• /cf spawnmob
• /cf spawner
• /cf kill
• /cf list
• /cf me
• /cf chaos

Village Scan

CommandFoundry includes /villagescan <radiusChunks> for staff testing.

Village scan:

• Loads and scans chunks in batches.
• Has a hard cap of 256 chunks.
• Finds generated vanilla village structures.
• Deduplicates results by structure bounding box.
• Shows nearest results first.
• Sends clickable chat entries for teleporting to results.
• Routes scan teleports through CommandFoundry teleport handling so /back records the origin.
• Supports /villagescan stop.

Configuration

Command groups can be enabled or disabled through module toggles.

Configurable modules include:

• Teleports.
• Homes.
• Warps.
• Spawn.
• Kits.
• Messaging.
• Mail.
• Player utilities.
• Info commands.
• Item commands.
• World tools.
• Workstations.
• Teleport extras.
• Chaos tools.
• Compatibility aliases.
• Moderation.
• Staff tools.
• Signs.

Command economy costs can be configured per supported command when StormEconomy is available.

Storage

CommandFoundry supports:

• SQLite
• YAML
• MySQL
• MariaDB

SQLite is the default:

• plugins/CommandFoundry/commandfoundry.db

Stored data includes player profiles, homes, warps, spawns, kits, kit cooldowns, /back locations, mail, ignore lists, punishments, jails, and audit records.

Remote database examples use hostname-verified TLS defaults and separate credential fields.

Permissions

CommandFoundry uses explicit permission nodes under commandfoundry.*.

Main aggregate permissions:

• commandfoundry.defaults
• commandfoundry.staff
• commandfoundry.moderation
• commandfoundry.admin

Common player permissions include:

• commandfoundry.command
• commandfoundry.spawn
• commandfoundry.home
• commandfoundry.home.set
• commandfoundry.home.delete
• commandfoundry.home.list
• commandfoundry.warp
• commandfoundry.warp.list
• commandfoundry.tpa
• commandfoundry.tpahere
• commandfoundry.tpaccept
• commandfoundry.tpdeny
• commandfoundry.tpcancel
• commandfoundry.back
• commandfoundry.rtp
• commandfoundry.kit
• commandfoundry.kit.list
• commandfoundry.msg
• commandfoundry.reply
• commandfoundry.ignore
• commandfoundry.mail
• commandfoundry.motd
• commandfoundry.rules
• commandfoundry.afk
• commandfoundry.nick
• commandfoundry.realname

Staff and admin permissions are op-gated by default and are declared explicitly in plugin.yml.

Optional Integrations

CommandFoundry can use optional integrations while remaining usable on its own.

• ThunderPerms can provide permission checks.
• StormEconomy can charge configured command costs.
• NPCs lets target-based commands resolve linked fake-player NPCs when no real online player matches the name.

CommandFoundry still loads when optional integrations are missing.

API And Events

CommandFoundry exposes a Bukkit service API.

The API can inspect:

• Homes.
• Warps.
• Spawn records.
• Kits.
• Kit claim readiness.
• /back locations.
• Vanish state.
• Freeze state.
• Jail state.
• Active punishments.
• Audit records.
• Storage health.

CommandFoundry also emits Bukkit events for home, warp, teleport, kit claim, punishment, vanish, and audit workflows.

Notes

CommandFoundry is intended for servers that want a native, auditable command suite rather than a compatibility wrapper. It keeps economy features in StormEconomy, avoids silently bypassing restrictions, declares its permissions explicitly, and audits destructive or privacy-sensitive staff actions.

It covers the common day-to-day command surface for players and staff while keeping high-risk actions behind guarded permissions and /cf admin subcommands.