Added Custom map generation for wipe schedule auto-pick — generates brand-new maps via RustMaps' custom map generation API using a saved config, instead of searching the existing map pool. Requires a RustMaps Premium (or higher) subscription. Generation is triggered an hour ahead of the vote and polled until ready, then staged exactly like manually-set or search-picked maps; falls back to notify or use_available if generation doesn't finish in time
Added Optional RUSTMAPS_ORG_ID env var for generating custom maps against an organization's RustMaps account instead of a personal one
Added Custom map generation is also available as a fourth map-sourcing method ("Custom Generate") in the Vote tab's manual vote creation flow, not just wipe schedule auto-pick — same RustMaps saved-config generation, with a live wait-and-refresh panel and keep/reroll controls since this flow is admin-driven rather than a background timer
Added Customizable Small/Medium/Large size icons and thresholds (Settings → Edit Appearance) — applies consistently across vote messages, results, /search, and every creation-flow preview panel, not just the live vote itself
Fixed /search's Size Range button no longer crashes — ModalBuilder, TextInputBuilder, and TextInputStyle were used without being imported in SearchHandler.js
Fixed Five modals (vote duration, vote title, and schedule-vote in the create flow; edit-duration and map-swap in the edit flow) now bust Discord's client-side modal cache the same way every other modal in the dashboard already did — previously reopening one of these could show a stale value left over from a prior session
Fixed Runoff votes now compute their duration correctly — createdAt is a UTC timestamp with no timezone marker, so parsing it directly was being read as local time; a runoff triggered by the runoff tiebreaker setting would run for the wrong length of time on any host not running in UTC
Fixed vote_appearance's showBiomes/showFeatures columns now default to 1 (on) in the schema, matching the v3.1.0 change that already flipped their JS-side defaults to true — new guilds could otherwise get a schema/code mismatch depending on insert order
Fixed Viewing monuments on a custom map's winner-result or vote-creation preview no longer calls the wrong RustMaps endpoint — handleWinnerMonuments/handlePreviewMonuments in VoteButtonHandler.js always called the standard-map endpoint (GET /{size}/{seed}), which only works for procedural maps; custom maps (manually-entered or generated) need the custom-map endpoint (GET /{mapId}) instead
Improved Accent color default extracted to DEFAULT_ACCENT_COLOR in mapConstants.js — replaces the same 0xFF5733 literal duplicated 31 times across 9 files with a single source of truth
Improved src/util/debounce.js removed — dead code left over from before dashboard-refresh debouncing was inlined directly into DashboardManager.js
Improved Vote button customIds no longer embed an unused timestamp — the map index alone was always sufficient to identify which button was pressed
Improved SettingsTab.js no longer imports formatDuration, which it never used
Improved voteDB.js's redundant duplicate directory-creation check removed, matching the single memory-aware check already used in configDB.js/wipeDB.js
Improved Monuments list is now grouped into categories (Military & Endgame, Mid-Tier Loot, Low-Tier Loot, Ocean, Safe Zones, Resources, Caves, Tunnels, Power Infrastructure, Rocks & Terrain, Ice & Water Features, Other Monuments) with a per-category count, instead of one long alphabetical wall of text — counts shown as a small badge, gas stations/lighthouses/supermarkets/warehouses still grouped under their own "Amenities" heading

Dependency Changes

Fixed Runoff tiebreaker now correctly starts a re-vote between tied maps — the tiebreaker column was absent on migrated databases, causing the setting to always fall back to random
Fixed Vote reminder messages are now deleted from the channel when the vote ends — previously they lingered after results were posted
Fixed Database migration now explicitly adds tiebreaker, mapCooldownCount, and accentColor columns to existing installations — these were in the CREATE TABLE definition but not in the migration checks, so migrations were silently missing them
Fixed Accent color setting now applies to vote messages — the configured color is merged into the appearance snapshot at vote creation time; votes no longer always render in the default orange
Fixed MapData.findOne and findOneAndUpdate no longer re-compile SQL on every call — statements are now cached by condition set, consistent with every other model
Fixed DROP COLUMN calls removed from the configDB.js migration — unused columns are left in place harmlessly
Fixed Redundant .filter(v => v.winnerMapId) removed from the cooldown calculation — Vote.findRecent already applies this filter in SQL
Changed Biomes and terrain features now shown by default on vote messages — showBiomes and showFeatures defaults changed from false to true
Improved Dashboard nav option renamed from "Overview" to "Refresh Stats" to better reflect what it does
Improved Bot status in online.js is now an array that rotates every 15 seconds when more than one entry is present — add entries below the existing copyright line without removing it
Improved Tie-breaker setting description clarified — runoff only triggers on a genuine vote tie; if no votes were cast at all, a winner is always chosen at random regardless of the setting
Improved Terrain, biome, and monument modal building and submit parsing extracted to src/util/filterForms.js — previously copy-pasted identically across SearchHandler, VoteCreateFlow, and AutomationTab
Improved Session cleanup extracted to src/util/SessionStore.js — identical Map + setInterval pattern was duplicated across four handlers
Improved handleAutomationInteraction split into _handleSchedConfig and _handleMonFilters sub-handlers — main function reduced to a routing switch

Added /setup command — creates the admin dashboard in a specified channel; moves it if it already exists
Added /search command — public map search with filters (size range, biome percentages, terrain counts, monuments); paginated results, 25 per page
Added Admin dashboard — single persistent message per guild with tabbed navigation (Overview, Vote, Automation, History, Settings)
Added Overview tab — live stats: total votes run, total community votes cast, completion rate, active vote status, and active schedule count
Added Vote tab — create and manage votes from within the dashboard; cancel or end active votes early
Added Automation tab — full wipe schedule management; create, edit, and delete schedules with all configuration inline
Added History tab — paginated past vote results with winner map links, vote counts, and a per-page win-rate breakdown by map size
Added Settings tab — guild configuration: accent color, voter role, map cooldown count, and vote appearance
Added Vote creation flow — three map-sourcing types: Manual (size + seed), Search (pick from live RustMaps results), and Auto-Pick (bot automatically picks)
Added Live vote editing — edit title, duration, appearance, voter roles, or swap a map on an active vote without ending it
Added Wipe scheduling — create weekly, biweekly, and monthly (by Nth weekday or last weekday) wipe schedules; schedules auto-rearm after firing
Added Wipe auto-pick — schedules can automatically select maps from RustMaps at fire time based on size, biome, terrain, and monument filters; configurable map count and fallback behavior
Added Map cooldown — guilds can configure a cooldown count that prevents recently-won maps from appearing in auto-picked votes
Added Voter roles — votes can require one or more specific Discord roles to participate; configured per vote at creation or edit time
Added Wipe reminder — sends a 24-hour advance notice to the vote channel when a schedule has no maps set and auto-pick is off
Added Vote message recovery — if the live vote message is deleted, the bot automatically re-sends it in the same channel and re-registers the timer
Added Dashboard message recovery — if the dashboard message is deleted, the bot re-creates it in the same channel on the next interaction or startup
Added Multi-schedule support — guilds can run multiple independent wipe schedules simultaneously, each with its own automation config
Added Pending map staging — maps can be queued on a schedule ahead of time; the staged maps are used when the schedule fires
Overhauled Database schema — added guild_config, vote_appearance, and wipe_schedule tables; vote table extended with appearance, voter roles, and template columns
Improved All SQLite models use prepared statements cached at module level — no statements are compiled at call time
Improved PRAGMA table_info used for all schema migrations — replaces silent try/catch ALTER TABLE so real errors are not swallowed
Improved Session keys include guildId in VoteCreateFlow and VoteEditFlow — fixes multi-guild session collisions where two users in different guilds shared a key
Removed /map_vote command — replaced by the Vote tab in the dashboard
Removed /vote_history command — replaced by the History tab in the dashboard

Dependency Changes

Fixed Invalid vote duration input is now rejected with a clear error — previously a bad format was silently ignored and the session duration was left unchanged with no feedback to the user
Fixed fireScheduledVote no longer throws if the target channel has been deleted — the vote is skipped gracefully instead of crashing the recovery handler
Fixed Vote timers created by _sendVote and scheduleVote are now tracked in VoteManager — untracked timers couldn't be cancelled on shutdown, risking double-end on restart
Fixed Redundant Vote.findOneAndUpdate call after endVoteWithResults removed from VoteManager._endVote — the extra call was unnecessary since endVoteWithResults already marks the vote inactive and saves the winner
Fixed Session is now cleared immediately after a vote goes live — previously the session lingered in memory until the 30-minute cleanup interval
Fixed SQLite migration now uses PRAGMA table_info to check column existence — the previous silent try/catch around ALTER TABLE swallowed real errors unrelated to duplicate columns
Improved All source files converted from CommonJS to ESM — removes the CommandKit transpiler as a silent dependency for correct module resolution
Improved All SQLite model methods are now correctly synchronous — async/await on synchronous better-sqlite3 calls was misleading and unnecessary
Improved Vote update on button press no longer re-fetches the vote from the database — vote counts are updated in-memory and the message is rebuilt from the already-populated object
Improved selectMapsByVoteIds and findByIdIn prepared statements are now cached by argument count — repeated calls with the same number of IDs reuse the compiled statement instead of re-preparing on every call
Improved mapId stored as a number throughout — was previously coerced to a string in _formatRow, causing unnecessary type inconsistency with the database schema
Improved voteManager is now attached to client — enables timer registration from voteFunctions and proper signal-handler cleanup on SIGTERM/SIGINT/SIGHUP

Dependency Changes

Fixed Bot entry point renamed from index.js to app.js — resolves startup failure on hosting providers that use node filepath as the startup command
Updated README updating guide