StepCraft

# StepCraft Mod - Update Changelog

**Release:** Incremental update (Minecraft mod only)

---

## Key Highlights

- Added full monthly leaderboard reward support in the mod.
- Added join-time private reminders for unclaimed regular and monthly rewards.
- Added customizable reminder messages with placeholders and Minecraft-style formatting.
- Added in-game admin controls for monthly reward structure/testing and join reminder settings.
- Cleaned up monthly reward commands so players use `/stepcraft monthly_leaderboard` instead of a separate claim command.
- Fixed dashboard links, page labels, and saved layout migration behavior.

---

## Monthly Leaderboard Reward Updates

- Added finalized monthly reward support to the player-facing monthly leaderboard flow.
- Added a backlog-style monthly reward claim UI so players can review and claim outstanding finalized monthly rewards.
- Updated monthly leaderboard wording to better explain qualification, tie-breakers, finalized months, and claimable rewards.
- Updated monthly reward screen iconography so monthly rewards use a trophy-style presentation instead of the old calendar-style visual.
- Removed the old `/stepcraft claim_monthly_reward` command.
- Monthly rewards are now accessed through:
  - `/stepcraft monthly_leaderboard`

---

## Admin Reward UI Updates

- Added monthly reward admin tools alongside the regular reward tools.
- Added View Monthly Reward Structure.
- Added Test Monthly Rewards.
- Kept Open Web Dashboard in its existing slot.
- Adjusted admin reward menu layout so regular and monthly reward controls fit cleanly together.

---

## Join Reminder Updates

- Added private join-time reminders for players with unclaimed rewards.
- Join reminders can include:
  - regular StepCraft rewards
  - monthly leaderboard rewards
- Added separate enable/disable controls for regular and monthly reminders in the in-game Join Reminders admin screen.
- Added a Manage Messages button in the Join Reminders admin screen.
- Manage Messages opens the server’s web dashboard message settings directly.

---

## Reminder Message Customization

- Added separate customizable message templates for:
  - regular reward reminders
  - monthly reward reminders
- Added placeholder support for reminder messages:
  - `{reward_count}`
  - `{reward_word}`
  - `{reward_names}`
  - `{reward_dates}`
  - `{reward_months}`
  - `{reward_list}`
  - `{claim_command}`
- Added backward-compatible `{summary}` handling so old reminder templates do not show raw placeholder text in chat.
- Added Minecraft-style formatting support in reminder messages:
  - color codes such as `&a`, `&6`, `&b`, `&c`, `&e`, `&f`
  - bold with `&l`
  - italic with `&o`
  - underline with `&n`
  - strikethrough with `&m`
  - reset with `&r`
  - literal ampersand with `&&`
  - hex colors such as `&#55ff55`
- Updated default reminder messages to use formatted text.

---

## Settings And Layout Fixes

- Restored the Settings screen wool API-key status indicator.
- Replaced the old Join Reminders paper Status item with Manage Messages.
- Added layout migration so older generated layout configs self-correct:
  - restores `settings_menu.status` to API Key Status wool
  - adds `reward_reminders_menu.manage_messages`
- Fixed saved layout behavior so the previous incorrect status-item change does not persist after updating.

---

## Dashboard Link Fixes

- Fixed mod-generated dashboard links.
- Staging builds now link to:
  - `https://staging.stepcraft.org/servers/<serverName>#join-reminders`
- Production builds now link to:
  - `https://stepcraft.org/servers/<serverName>#join-reminders`
- Removed the incorrect `/dashboard/servers/...` path from generated mod links.

---

## Paged Screen Improvements

- Fixed page indicators across paged mod screens.
- Single-page screens now show clearer page labels such as:
  - `Page 1/1`
- This replaces ambiguous labels that only said:
  - `Page`

---

## New/Updated Layout Keys

- Added: `reward_reminders_menu.manage_messages`
- Updated: `settings_menu.status`
- Added: `rewards_menu.view_monthly_rewards`
- Added: `rewards_menu.test_monthly_rewards`

---

## Compatibility Notes

- Existing configs remain compatible.
- Older layout configs are migrated automatically where possible.
- Existing reminder message templates continue to work.
- Old `{summary}` reminder templates are handled safely for backward compatibility.