Skip to content

Commit 11a8b33

Browse files
committed
Refresh SchedulerCheck public docs
1 parent cfd22ec commit 11a8b33

10 files changed

Lines changed: 256 additions & 228 deletions

File tree

project-docs/README.md

Lines changed: 56 additions & 56 deletions
Original file line numberDiff line numberDiff line change
@@ -81,62 +81,62 @@ Paper loads normal plugin jars from the top-level server `/plugins/` directory.
8181

8282
- `plugins/CMI-<version>.jar`
8383
- `plugins/CMILib<version>.jar`
84-
- `plugins/1MB-CMIAPI-LIB-v1.0.0-385-j25-26.1.2.jar`
85-
- `plugins/1MB-CMIAPI-AFKShrine-v1.0.0-385-j25-26.1.2.jar` provides CMI AFK shrine effects, player-selectable particle presets, AFKShrine points, claim/trade rewards, milestones, quests, and leaderboards
86-
- `plugins/1MB-CMIAPI-RecordingMode-v1.0.0-385-j25-26.1.2.jar`
87-
- `plugins/1MB-CMIAPI-SellStreaks-v1.0.0-385-j25-26.1.2.jar`
88-
- `plugins/1MB-CMIAPI-ScheduledTips-v1.0.0-385-j25-26.1.2.jar`
89-
- `plugins/1MB-CMIAPI-Visit-v1.0.0-385-j25-26.1.2.jar` provides player-owned hidden CMI visit warps with safe welcome messages, arrival titles, particles, sounds, and top-visit perk unlocks
90-
- `plugins/1MB-CMIAPI-PassportDiscovery-v1.0.0-385-j25-26.1.2.jar` includes `/passport warp`, replacing legacy WarpPassport for new installs
91-
- `plugins/1MB-CMIAPI-SocialGatherings-v1.0.0-385-j25-26.1.2.jar`
92-
- `plugins/1MB-CMIAPI-JourneyMap-v1.0.0-385-j25-26.1.2.jar`
93-
- `plugins/1MB-CMIAPI-KitStreaks-v1.0.0-385-j25-26.1.2.jar`
94-
- `plugins/1MB-CMIAPI-MessageFont-v1.0.0-385-j25-26.1.2.jar`
95-
- `plugins/1MB-CMIAPI-Nick-v1.0.0-385-j25-26.1.2.jar` provides safer `/nick` presets, GUI previews, cooldowns, related-name checks, history, favorites, ratings, and CMI nickname delegation
96-
- `plugins/1MB-CMIAPI-EmoteMenu-v1.0.0-385-j25-26.1.2.jar` provides `/emotes` with a hardened light-blue GUI, Paper dialog search, target picking, and CMI CustomAlias-backed emote review
97-
- `plugins/1MB-CMIAPI-PvPToggle-v1.0.0-385-j25-26.1.2.jar`
98-
- `plugins/1MB-CMIAPI-Boosters-v1.0.0-385-j25-26.1.2.jar`
99-
- `plugins/1MB-CMIAPI-NameMC-v1.0.0-385-j25-26.1.2.jar`
100-
- `plugins/1MB-CMIAPI-Trades-v1.0.0-385-j25-26.1.2.jar` provides `/trade`, migrated from the old standalone 1MBTrades plugin
101-
- `plugins/1MB-CMIAPI-VoteTokens-v1.0.0-385-j25-26.1.2.jar` provides `/votetokens` secure vote-token GUI trades, CMI kit rewards, hidden reward identity markers, reward setup item creation, extra-token item tools with shield presets, and staff migration tools for old manual trades
102-
- `plugins/1MB-CMIAPI-DiscordChat-v1.0.0-385-j25-26.1.2.jar` provides `/discordchat` DiscordSRV server-chat engagement tracking, quality-gated EXP, conversation clusters, first-Discord broadcasts, community pulse, recurring bonus windows, linked-account streaks, point rewards, safe item tools, dependency-aware reward checks, opt-out reminders, milestone celebration privacy, and staff smoke/community/economy/archive/award reports
103-
- `plugins/1MB-CMIAPI-GameTypes-v1.0.0-385-j25-26.1.2.jar` provides `/gametype` safe BentoBox game type menus for OneBlock, SkyBlock, AcidIsland, CaveBlock, and SkyGrid
104-
- `plugins/1MB-CMIAPI-BirthdayLanterns-v1.0.0-385-j25-26.1.2.jar` provides `/birthday` collectible birthday, player anniversary, and server milestone lantern rewards with GUI claims, PDC item identity, finite wish charges, guestbook notes, presets, mail variants, and configurable CMI reward commands
105-
- `plugins/1MB-CMIAPI-MobHat-v1.0.0-385-j25-26.1.2.jar`
106-
- `plugins/1MB-CMIAPI-PlayerTodo-v1.0.0-385-j25-26.1.2.jar`
107-
- `plugins/1MB-CMIAPI-Refer-v1.0.0-385-j25-26.1.2.jar`
108-
- `plugins/1MB-CMIAPI-TPAuto-v1.0.0-385-j25-26.1.2.jar`
109-
- `plugins/1MB-CMIAPI-Menu-v1.0.0-385-j25-26.1.2.jar`
110-
- `plugins/1MB-CMIAPI-StaffCenter-v1.0.0-385-j25-26.1.2.jar`
111-
- `plugins/1MB-CMIAPI-Profile-v1.0.0-385-j25-26.1.2.jar` provides `/profile` for staff-only Java/Bedrock identity review, cached CMI/log signals, Mojang account status, remote profile context, public ban-list review signals, manual notes, and Markdown exports
112-
- `plugins/1MB-CMIAPI-FilterLab-v1.0.0-385-j25-26.1.2.jar`
113-
- `plugins/1MB-CMIAPI-FilterGuard-v1.0.0-385-j25-26.1.2.jar`
114-
- `plugins/1MB-CMIAPI-WarningLens-v1.0.0-385-j25-26.1.2.jar`
115-
- `plugins/1MB-CMIAPI-NotableMsg-v1.0.0-385-j25-26.1.2.jar`
116-
- `plugins/1MB-CMIAPI-1MBStaffMsg-v1.0.0-385-j25-26.1.2.jar`
117-
- `plugins/1MB-CMIAPI-CmdCostDashboard-v1.0.0-385-j25-26.1.2.jar`
118-
- `plugins/1MB-CMIAPI-CMIConfig-v1.0.0-385-j25-26.1.2.jar`
119-
- `plugins/1MB-CMIAPI-ConsoleNoiseRouter-v1.0.0-385-j25-26.1.2.jar`
120-
- `plugins/1MB-CMIAPI-EconomyGuardian-v1.0.0-385-j25-26.1.2.jar`
121-
- `plugins/1MB-CMIAPI-StartupDoctor-v1.0.0-385-j25-26.1.2.jar`
122-
- `plugins/1MB-CMIAPI-UpdateSmoke-v1.0.0-385-j25-26.1.2.jar`
123-
- `plugins/1MB-CMIAPI-PluginVersions-v1.0.0-385-j25-26.1.2.jar` provides plugin inventory, tested Java/Paper/dependency gate checks, URL curation, and Markdown/Discord exports
124-
- `plugins/1MB-CMIAPI-Potions-v1.0.0-385-j25-26.1.2.jar` provides `/_potions` for locked admin custom event potion forging plus player-safe `/potions` held-item inspection, split config/potions/particles files, PDC identity, GUI definition editing, collection bundle generation, 14-style generation, snapshotted item costs, particle/collection metadata, and runtime disable controls
125-
- `plugins/1MB-CMIAPI-SchedulerCheck-v1.0.0-385-j25-26.1.2.jar` provides direct-console `/_scheduler` checks for CMI scheduler YAML syntax, timing values, command lists, enabled toggles, and Markdown exports
126-
- `plugins/1MB-CMIAPI-Upgrade-v1.0.0-385-j25-26.1.2.jar` provides `/_upgrade` admin-only LuckPerms group upgrade suggestions and read-only rankup simulation from join date and playtime signals, with a review queue GUI, clickable inspect/apply actions, guarded re-checks, side-group preservation, optional cosmetic permission rewards, promotion feedback effects, Discord link reminders, and split `config.yml`/`groups.yml`
127-
- `plugins/1MB-CMIAPI-EndCrystals-v1.0.0-385-j25-26.1.2.jar` provides `/_endcrystals`, migrated from the old standalone 1MB-EndCrystals plugin
128-
- `plugins/1MB-CMIAPI-WorldSnapshot-v1.0.0-385-j25-26.1.2.jar`
129-
- `plugins/1MB-CMIAPI-SparkReviewer-v1.0.0-385-j25-26.1.2.jar`
130-
- `plugins/1MB-CMIAPI-Hoppers-v1.0.0-385-j25-26.1.2.jar` provides `/_hoppers` for read-only hopper clog, watch/trigger/baseline, report comparison, storage-chain/container/material/redstone/ticket deep dives, world/chunk/player, region, Spark, notes, drift, history, and recommendation triage
131-
- `plugins/1MB-CMIAPI-EventRecorder-v1.0.0-385-j25-26.1.2.jar`
132-
- `plugins/1MB-CMIAPI-CMIProbe-v1.0.0-385-j25-26.1.2.jar`
133-
- `plugins/1MB-CMIAPI-CMIDatabase-v1.0.0-385-j25-26.1.2.jar`
134-
- `plugins/1MB-CMIAPI-PlaceholderProbe-v1.0.0-385-j25-26.1.2.jar`
135-
- `plugins/1MB-CMIAPI-CMIPlaceholderCheck-v1.0.0-385-j25-26.1.2.jar`
136-
- `plugins/1MB-CMIAPI-1MBPlaceholders-v1.0.0-385-j25-26.1.2.jar` provides the migrated `%onemb_<key>%` PlaceholderAPI expansion and keeps `/_placeholders`
137-
- `plugins/1MB-CMIAPI-WarpAudit-v1.0.0-385-j25-26.1.2.jar` provides read-only CMI warp and portal hygiene checks
138-
- `plugins/1MB-CMIAPI-WorthDrift-v1.0.0-385-j25-26.1.2.jar`
139-
- `plugins/1MB-CMIAPI-WorthHelper-v1.0.0-385-j25-26.1.2.jar` provides `/worthhelper` for read-only CMI Worth.yml and Paper recipe review exports
84+
- `plugins/1MB-CMIAPI-LIB-v1.0.0-389-j25-26.1.2.jar`
85+
- `plugins/1MB-CMIAPI-AFKShrine-v1.0.0-389-j25-26.1.2.jar` provides CMI AFK shrine effects, player-selectable particle presets, AFKShrine points, claim/trade rewards, milestones, quests, and leaderboards
86+
- `plugins/1MB-CMIAPI-RecordingMode-v1.0.0-389-j25-26.1.2.jar`
87+
- `plugins/1MB-CMIAPI-SellStreaks-v1.0.0-389-j25-26.1.2.jar`
88+
- `plugins/1MB-CMIAPI-ScheduledTips-v1.0.0-389-j25-26.1.2.jar`
89+
- `plugins/1MB-CMIAPI-Visit-v1.0.0-389-j25-26.1.2.jar` provides player-owned hidden CMI visit warps with safe welcome messages, arrival titles, particles, sounds, and top-visit perk unlocks
90+
- `plugins/1MB-CMIAPI-PassportDiscovery-v1.0.0-389-j25-26.1.2.jar` includes `/passport warp`, replacing legacy WarpPassport for new installs
91+
- `plugins/1MB-CMIAPI-SocialGatherings-v1.0.0-389-j25-26.1.2.jar`
92+
- `plugins/1MB-CMIAPI-JourneyMap-v1.0.0-389-j25-26.1.2.jar`
93+
- `plugins/1MB-CMIAPI-KitStreaks-v1.0.0-389-j25-26.1.2.jar`
94+
- `plugins/1MB-CMIAPI-MessageFont-v1.0.0-389-j25-26.1.2.jar`
95+
- `plugins/1MB-CMIAPI-Nick-v1.0.0-389-j25-26.1.2.jar` provides safer `/nick` presets, GUI previews, cooldowns, related-name checks, history, favorites, ratings, and CMI nickname delegation
96+
- `plugins/1MB-CMIAPI-EmoteMenu-v1.0.0-389-j25-26.1.2.jar` provides `/emotes` with a hardened light-blue GUI, Paper dialog search, target picking, and CMI CustomAlias-backed emote review
97+
- `plugins/1MB-CMIAPI-PvPToggle-v1.0.0-389-j25-26.1.2.jar`
98+
- `plugins/1MB-CMIAPI-Boosters-v1.0.0-389-j25-26.1.2.jar`
99+
- `plugins/1MB-CMIAPI-NameMC-v1.0.0-389-j25-26.1.2.jar`
100+
- `plugins/1MB-CMIAPI-Trades-v1.0.0-389-j25-26.1.2.jar` provides `/trade`, migrated from the old standalone 1MBTrades plugin
101+
- `plugins/1MB-CMIAPI-VoteTokens-v1.0.0-389-j25-26.1.2.jar` provides `/votetokens` secure vote-token GUI trades, CMI kit rewards, hidden reward identity markers, reward setup item creation, extra-token item tools with shield presets, and staff migration tools for old manual trades
102+
- `plugins/1MB-CMIAPI-DiscordChat-v1.0.0-389-j25-26.1.2.jar` provides `/discordchat` DiscordSRV server-chat engagement tracking, quality-gated EXP, conversation clusters, first-Discord broadcasts, community pulse, recurring bonus windows, linked-account streaks, point rewards, safe item tools, dependency-aware reward checks, opt-out reminders, milestone celebration privacy, and staff smoke/community/economy/archive/award reports
103+
- `plugins/1MB-CMIAPI-GameTypes-v1.0.0-389-j25-26.1.2.jar` provides `/gametype` safe BentoBox game type menus for OneBlock, SkyBlock, AcidIsland, CaveBlock, and SkyGrid
104+
- `plugins/1MB-CMIAPI-BirthdayLanterns-v1.0.0-389-j25-26.1.2.jar` provides `/birthday` collectible birthday, player anniversary, and server milestone lantern rewards with GUI claims, PDC item identity, finite wish charges, guestbook notes, presets, mail variants, and configurable CMI reward commands
105+
- `plugins/1MB-CMIAPI-MobHat-v1.0.0-389-j25-26.1.2.jar`
106+
- `plugins/1MB-CMIAPI-PlayerTodo-v1.0.0-389-j25-26.1.2.jar`
107+
- `plugins/1MB-CMIAPI-Refer-v1.0.0-389-j25-26.1.2.jar`
108+
- `plugins/1MB-CMIAPI-TPAuto-v1.0.0-389-j25-26.1.2.jar`
109+
- `plugins/1MB-CMIAPI-Menu-v1.0.0-389-j25-26.1.2.jar`
110+
- `plugins/1MB-CMIAPI-StaffCenter-v1.0.0-389-j25-26.1.2.jar`
111+
- `plugins/1MB-CMIAPI-Profile-v1.0.0-389-j25-26.1.2.jar` provides `/profile` for staff-only Java/Bedrock identity review, cached CMI/log signals, Mojang account status, remote profile context, public ban-list review signals, manual notes, and Markdown exports
112+
- `plugins/1MB-CMIAPI-FilterLab-v1.0.0-389-j25-26.1.2.jar`
113+
- `plugins/1MB-CMIAPI-FilterGuard-v1.0.0-389-j25-26.1.2.jar`
114+
- `plugins/1MB-CMIAPI-WarningLens-v1.0.0-389-j25-26.1.2.jar`
115+
- `plugins/1MB-CMIAPI-NotableMsg-v1.0.0-389-j25-26.1.2.jar`
116+
- `plugins/1MB-CMIAPI-1MBStaffMsg-v1.0.0-389-j25-26.1.2.jar`
117+
- `plugins/1MB-CMIAPI-CmdCostDashboard-v1.0.0-389-j25-26.1.2.jar`
118+
- `plugins/1MB-CMIAPI-CMIConfig-v1.0.0-389-j25-26.1.2.jar`
119+
- `plugins/1MB-CMIAPI-ConsoleNoiseRouter-v1.0.0-389-j25-26.1.2.jar`
120+
- `plugins/1MB-CMIAPI-EconomyGuardian-v1.0.0-389-j25-26.1.2.jar`
121+
- `plugins/1MB-CMIAPI-StartupDoctor-v1.0.0-389-j25-26.1.2.jar`
122+
- `plugins/1MB-CMIAPI-UpdateSmoke-v1.0.0-389-j25-26.1.2.jar`
123+
- `plugins/1MB-CMIAPI-PluginVersions-v1.0.0-389-j25-26.1.2.jar` provides plugin inventory, tested Java/Paper/dependency gate checks, URL curation, and Markdown/Discord exports
124+
- `plugins/1MB-CMIAPI-Potions-v1.0.0-389-j25-26.1.2.jar` provides `/_potions` for locked admin custom event potion forging plus player-safe `/potions` held-item inspection, split config/potions/particles files, PDC identity, GUI definition editing, collection bundle generation, 14-style generation, snapshotted item costs, particle/collection metadata, and runtime disable controls
125+
- `plugins/1MB-CMIAPI-SchedulerCheck-v1.0.0-389-j25-26.1.2.jar` provides direct-console `/_scheduler` checks for CMI scheduler YAML syntax, timing values, command lists, enabled toggles, and Markdown exports
126+
- `plugins/1MB-CMIAPI-Upgrade-v1.0.0-389-j25-26.1.2.jar` provides `/_upgrade` admin-only LuckPerms group upgrade suggestions and read-only rankup simulation from join date and playtime signals, with a review queue GUI, clickable inspect/apply actions, guarded re-checks, side-group preservation, optional cosmetic permission rewards, promotion feedback effects, Discord link reminders, and split `config.yml`/`groups.yml`
127+
- `plugins/1MB-CMIAPI-EndCrystals-v1.0.0-389-j25-26.1.2.jar` provides `/_endcrystals`, migrated from the old standalone 1MB-EndCrystals plugin
128+
- `plugins/1MB-CMIAPI-WorldSnapshot-v1.0.0-389-j25-26.1.2.jar`
129+
- `plugins/1MB-CMIAPI-SparkReviewer-v1.0.0-389-j25-26.1.2.jar`
130+
- `plugins/1MB-CMIAPI-Hoppers-v1.0.0-389-j25-26.1.2.jar` provides `/_hoppers` for read-only hopper clog, watch/trigger/baseline, report comparison, storage-chain/container/material/redstone/ticket deep dives, world/chunk/player, region, Spark, notes, drift, history, and recommendation triage
131+
- `plugins/1MB-CMIAPI-EventRecorder-v1.0.0-389-j25-26.1.2.jar`
132+
- `plugins/1MB-CMIAPI-CMIProbe-v1.0.0-389-j25-26.1.2.jar`
133+
- `plugins/1MB-CMIAPI-CMIDatabase-v1.0.0-389-j25-26.1.2.jar`
134+
- `plugins/1MB-CMIAPI-PlaceholderProbe-v1.0.0-389-j25-26.1.2.jar`
135+
- `plugins/1MB-CMIAPI-CMIPlaceholderCheck-v1.0.0-389-j25-26.1.2.jar`
136+
- `plugins/1MB-CMIAPI-1MBPlaceholders-v1.0.0-389-j25-26.1.2.jar` provides the migrated `%onemb_<key>%` PlaceholderAPI expansion and keeps `/_placeholders`
137+
- `plugins/1MB-CMIAPI-WarpAudit-v1.0.0-389-j25-26.1.2.jar` provides read-only CMI warp and portal hygiene checks
138+
- `plugins/1MB-CMIAPI-WorthDrift-v1.0.0-389-j25-26.1.2.jar`
139+
- `plugins/1MB-CMIAPI-WorthHelper-v1.0.0-389-j25-26.1.2.jar` provides `/worthhelper` for read-only CMI Worth.yml and Paper recipe review exports
140140

141141
The common `1MB-CMIAPI-` prefix keeps the jars grouped together when sorted by name. Repository folders and build output may be organized by category, but installed runtime jars should stay in `/plugins/` for normal Paper loading and feature isolation.
142142

project-docs/SYNCED_FROM.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
This folder is a public documentation-only copy of selected files from the private `mrfdev/1MB-CMIAPI` repository.
44

55
- Source path: `/Users/floris/Projects/Codex/CMI-API`
6-
- Source commit: `a836237`
6+
- Source commit: `847a98f`
77
- Source state: `local changes present at sync time`
88
- Copied files: `README.md` and `docs/`
99
- Excluded on purpose: source code, jars, servers, databases, task logs, and internal checklists

project-docs/docs/commands.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1143,18 +1143,22 @@ SchedulerCheck:
11431143
/_scheduler list all
11441144
/_scheduler list enabled
11451145
/_scheduler list disabled
1146+
/_scheduler list error
11461147
/_scheduler list id Announcer
11471148
/_scheduler set Announcer false
11481149
/_scheduler set Announcer true
11491150
/_scheduler set Announcer false --reason quiet during maintenance
11501151
/_scheduler set Announcer enabled true --reason tested from console
1152+
/_scheduler fix resetWeatherTime PerformOn.2.Hour 23
1153+
/_scheduler fix resetWeatherTime PerformOn.2.Hour 23 --apply --reason invalid hour hotfix
1154+
/_scheduler fix Announcer Feedback false --apply --reason strict boolean cleanup
11511155
/_scheduler create morningAnnouncer daily 6 0 false --command broadcast! Good morning from 1MoreBlock --reason draft test
11521156
/_scheduler create pinataClear delay 600 false --command asFakeOp! pinata killall --command actionbar! &ePinatas cleared
11531157
/_scheduler reload
11541158
/_scheduler debug all
11551159
```
11561160

1157-
`/_scheduler` is direct-console only and has no aliases. It reads CMI `Settings/Schedules.yml` or `Scheduler.yml`, validates YAML syntax, type/range values such as `Hour: 0-23`, strict booleans, command list shape, specialized CMI command prefixes, risky command roots, duplicate enabled schedules, typo-prone ids, and schedule trigger logic. `/_scheduler export` writes a full Markdown report, while `/_scheduler export discord` writes a shorter findings summary. `/_scheduler set <key> true|false [--reason <text>]` only changes one `Enabled:` line and reminds the owner that a full `/stop` and start is the cleanest way to apply CMI scheduler changes. `/_scheduler create` can append simple interval or daily schedule entries from console.
1161+
`/_scheduler` is direct-console only and has no aliases. It reads CMI `Settings/Schedules.yml` or `Scheduler.yml`, validates YAML syntax, type/range values such as `Hour: 0-23`, strict booleans, command list shape, specialized CMI command prefixes, risky command roots, duplicate enabled schedules, typo-prone ids, and schedule trigger logic. `/_scheduler export` writes a full Markdown report, while `/_scheduler export discord` writes a shorter findings summary. `/_scheduler set <key> true|false [--reason <text>]` only changes one `Enabled:` line and reminds the owner that a full `/stop` and start is the cleanest way to apply CMI scheduler changes. `/_scheduler fix <key> <path> <value>` is a dry-run-first scalar hotfix for validated fields such as `Feedback`, `Delay`, and `PerformOn.1.Hour`; add `--apply` to back up the file and write the line-preserving change. `/_scheduler create` can append simple interval or daily schedule entries from console.
11581162

11591163
EndCrystals:
11601164

project-docs/docs/compiling.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -24,10 +24,10 @@ gradle clean refreshBuildDocs build
2424
Expected jar naming:
2525

2626
```text
27-
1MB-CMIAPI-LIB-v1.0.0-385-j25-26.1.2.jar
28-
1MB-CMIAPI-AFKShrine-v1.0.0-385-j25-26.1.2.jar
29-
1MB-CMIAPI-StaffCenter-v1.0.0-385-j25-26.1.2.jar
30-
1MB-CMIAPI-Profile-v1.0.0-385-j25-26.1.2.jar
27+
1MB-CMIAPI-LIB-v1.0.0-389-j25-26.1.2.jar
28+
1MB-CMIAPI-AFKShrine-v1.0.0-389-j25-26.1.2.jar
29+
1MB-CMIAPI-StaffCenter-v1.0.0-389-j25-26.1.2.jar
30+
1MB-CMIAPI-Profile-v1.0.0-389-j25-26.1.2.jar
3131
```
3232

3333
After a successful feature or library build, copy the output jar into:

0 commit comments

Comments
 (0)