86 lines
3.5 KiB
Markdown
86 lines
3.5 KiB
Markdown
|
# Roadmap — Command Surface Cleanup
|
||
|
|
|
||
|
|
**Goal:** one canonical command per action. Aliases hard-disabled (not just PAT-blocked-with-msg). `/msg` should literally not exist when canonical is `/pm`. Same for all multi-alias commands.
|
||
|
|
|
||
|
|
**Why hard-disable vs PAT-block-message:**
|
||
|
|
- PAT-block shows a message → still discoverable via tab-complete or "huh that exists?"
|
||
|
|
- Hard-disable removes from registration → command tree clean, no message, never discoverable
|
||
|
|
- Polish goal: "minimal feels like product, not jank-server"
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Canonical decisions (operator-locked)
|
||
|
|
|
||
|
|
| Action | Canonical | Aliases to hard-disable | Source override |
|
||
|
|
|---|---|---|---|
|
||
|
|
| Private msg | `/pm` | `/msg /tell /m /t /w /whisper` | s8n exec 2026-05-07 19:08-19:13 |
|
||
|
|
| Reply | `/r` | `/reply` | (decide) |
|
||
|
|
| Home set | `/sethome` | `/createhome /sh` | (decide) |
|
||
|
|
| Land claim | `/claim` | `/region /rg /hs claim` | (decide) |
|
||
|
|
| Help | `/help` | (no aliases) | post-restart aliases.yml routes to helpcommand:help |
|
||
|
|
| Nick | `/nick` | `/nickname` | (decide) |
|
||
|
|
|
||
|
|
## Mechanisms to hard-disable
|
||
|
|
|
||
|
|
**Per-plugin disable** (preferred — clean):
|
||
|
|
1. **Essentials** — add to `/data/plugins/Essentials/config.yml` `disabled-commands:` list. Removes from registration. Example:
|
||
|
|
```yaml
|
||
|
|
disabled-commands:
|
||
|
|
- msg
|
||
|
|
- tell
|
||
|
|
- m
|
||
|
|
- t
|
||
|
|
- w
|
||
|
|
- whisper
|
||
|
|
- reply
|
||
|
|
- createhome
|
||
|
|
- sh
|
||
|
|
- nickname
|
||
|
|
```
|
||
|
|
2. **CarbonChat** — has own /msg /tell /reply etc. Either:
|
||
|
|
- Set `should-register-commands=false` in carbon channel configs (suppress channel cmds)
|
||
|
|
- Use `command-aliases=[]` to clear aliases
|
||
|
|
- For built-in carbon commands: edit `/data/plugins/CarbonChat/command-settings.conf` (per-command toggle if available)
|
||
|
|
3. **Bukkit `commands.yml`** — `unknown-command-message: ""` plus alias remap. Server-level fallback. Useful for cmds with no plugin-level disable.
|
||
|
|
|
||
|
|
**Server-level alias override** (fallback):
|
||
|
|
- `/opt/docker/minecraft/commands.yml`:
|
||
|
|
```yaml
|
||
|
|
aliases:
|
||
|
|
pm: ["essentials:msg $1-"] # /pm fires Essentials' /msg
|
||
|
|
```
|
||
|
|
+ Essentials' /msg disabled per above. Result: only /pm works.
|
||
|
|
|
||
|
|
**Note**: aliases.yml entries are SERVER-WIDE; perms still apply. Test on staging.
|
||
|
|
|
||
|
|
## Implementation phases
|
||
|
|
|
||
|
|
### Phase 1 — quick wins (no restart)
|
||
|
|
- Edit `/data/plugins/Essentials/config.yml` `disabled-commands:` add `tell, m, t, w, whisper, createhome, sh, nickname` (keep `msg` for now until /pm is canonical)
|
||
|
|
- Carbon `should-register-commands=false` for any redundant cmd
|
||
|
|
- `essentials reload`
|
||
|
|
|
||
|
|
### Phase 2 — canonical /pm switch (during chat-plugin migration)
|
||
|
|
- Set `/pm` as the canonical via aliases.yml
|
||
|
|
- Disable Essentials `/msg`
|
||
|
|
- Update COMMANDS.md
|
||
|
|
- Test in-game with YOU500
|
||
|
|
|
||
|
|
### Phase 3 — log all command-disable behavior (s8n ask: "log everything")
|
||
|
|
- Wrap PAT block messages with audit log (PAT already does this somewhat)
|
||
|
|
- Add `EssentialsX` audit-log: `/data/plugins/Essentials/config.yml` debug + log-output
|
||
|
|
- Consider Logger Plugin (e.g. spark profiler-style command audit) for full cmd execution log
|
||
|
|
|
||
|
|
## Decisions still pending
|
||
|
|
- Hard list of all aliases to drop per command
|
||
|
|
- Reply: `/r` vs `/reply`
|
||
|
|
- Home set: `/sethome` vs `/createhome`
|
||
|
|
- Nick: `/nick` vs `/nickname`
|
||
|
|
- Should `/co` (CoreProtect) be visible to defaults?
|
||
|
|
|
||
|
|
## Risk
|
||
|
|
|
||
|
|
- Disabling command at Essentials level may break user muscle memory — onboarding doc will need to make canonical names obvious
|
||
|
|
- Carbon's command-settings may not allow per-command disable; may need plugin patch or fork (deferred to chat-plugin migration)
|
||
|
|
- Test ALL changes on a clone branch before live restart
|