# 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 ` - `/homes` - `/warp ` - `/warps` - `/tpa ` - `/tpahere ` - `/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 ` - `/kitreset [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 ` - `/reply ` - `/r ` - `/ignore ` - `/mail read|send|clear` - `/rtoggle` - `/broadcast ` - `/broadcastworld [world] ` - `/helpop ` - `/socialspy` - `/commandspy` - `/motd` - `/rules` - `/info [key]` - `/customtext ` 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 ` - `/enderchest [player]` - `/fly [player]` - `/speed fly|movement ` - `/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 [player]` - `/pweather [player]` - `/rest [player]` - `/skull ` - `/unlimited` - `/whois ` Workstation commands include: - `/workbench` - `/anvil` - `/cartographytable` - `/grindstone` - `/loom` - `/smithingtable` - `/stonecutter` - `/trash` ## Moderation Moderation tools include: - `/mute [duration] [reason]` - `/warn [reason]` - `/jail [duration] [reason]` - `/unjail ` - `/jailedplayers` - `/deljail ` - `/freeze [duration] [reason]` - `/unfreeze ` - `/sudo /` - `/unbanip

` 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 ` 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.

CommandFoundry

0.1.0