[TACZ] QuestCreator

TaczQuestCreator - CurseForge Description

  Full Description

  # TaczQuestCreator

  A comprehensive quest board system designed for multiplayer servers running Minecraft Forge 1.20.1.

  TaczQuestCreator provides a fully featured, server-authoritative quest framework with a rotating quest board, premium
  rewards, difficulty scaling, and deep integration with popular mods.

  ---

  ## Features

  ### Quest Board
  - Rotating quest board with **6 normal slots** and **3 premium slots** (configurable)
  - Auto-refreshes on a configurable timer (default: 30 minutes)
  - Manual refresh via admin command
  - Players can hold up to **3 active quests** simultaneously (configurable)
  - Beautiful dark-themed UI with difficulty stars, target icons, and reward previews

  ### 6 Quest Types
  - **Collect Items** — Gather specific items (auto-detected from inventory)
  - **Kill Entities** — Slay mobs or specific entity types
  - **Gun Kill** — Kill entities with TACZ firearms, optionally filtered by weapon type (requires TACZ)
  - **Survive Waves** — Survive defense waves in clan zones (requires Clans System)
  - **Capture** — Complete KOTH or city capture events (requires Clans System)
  - **Extract** — Successfully complete extraction objectives (requires Clans System)

  ### Multi-Target Quests
  A single quest can require multiple objectives (e.g., "Kill 5 Zombies AND 3 Skeletons"). Each target tracks progress
  independently and all must be completed to finish the quest.

  ### Flexible Reward System
  - **Item rewards** with full NBT support (enchantments, custom model data, lore, etc.)
  - **Experience rewards**
  - **Command rewards** (execute any server command on completion)
  - **Drop chance** per reward (0–100%) for randomized loot
  - All rewards scale with difficulty and premium tier

  ### Difficulty Scaling
  - Quests support a **1–5 star difficulty** rating
  - Optional **random difficulty** — each board refresh rolls a new difficulty
  - Target amounts, rewards, time limits, costs, and money rewards all scale automatically

  ### Premium Tier System
  - **3 tiers**: Normal (1x), Premium (1.5x), VIP (2.0x) — multipliers are configurable
  - Premium-exclusive quest slots on the board
  - Reward multipliers applied to all reward types
  - Assign tiers via command or permission nodes

  ### Economy Integration
  - **Command mode** (default): Works with any economy plugin (Vault, EssentialsX, etc.) via configurable commands
  - **HudCreator mode**: Direct API integration with HudCreator's economy system
  - Quest accept costs and money rewards, both scaled by difficulty

  ### HUD Overlay
  - Persistent on-screen display of active quests
  - Shows quest name, progress bar, and remaining time
  - Fully repositionable via config
  - Can be toggled on/off

  ### Admin Tools
  - In-game GUI for **creating, editing, listing, enabling/disabling, and deleting** quests
  - **JSON export/import** — back up your quests or share them between servers
  - `/questadmin reload` to hot-reload quest definitions without restart
  - `/questadmin refresh` to manually refresh the quest board

  ---

  ## Commands

  | Command | Permission | Description |
  | `/questboard` | Everyone | Opens the quest board |
  | `/questadmin create` | OP (level 2) | Opens the quest creation GUI |
  | `/questadmin list` | OP (level 2) | Lists all quests with admin controls |
  | `/questadmin reload` | OP (level 2) | Reloads quests from JSON files |
  | `/questadmin export` | OP (level 2) | Exports all quests to JSON |
  | `/questadmin refresh` | OP (level 2) | Forces a board refresh |
  | `/questadmin setpremium <player> <0|1|2>` | OP (level 2) | Sets a player's premium tier |

  ---

  ## Configuration

  All settings are available in `taczquestcreator-common.toml`:

  - **Board refresh interval** (default: 30 minutes)
  - **Normal & premium quest slot counts**
  - **Max active quests per player**
  - **Default quest duration**
  - **Premium system toggle & multipliers**
  - **Economy mode & commands**
  - **HUD toggle & position**

  ---

  ## Compatibility

  ### Minecraft & Forge
  - **Minecraft**: 1.20.1
  - **Forge**: 47.2.0+

  ### Supported Mod Integrations (Optional)

  | Mod | Integration |
  |---|---|
  | **TACZ (Timeless and Classics Guns)** | Enables the "Gun Kill" quest type — track kills by weapon type |
  | **Clans System** | Enables "Survive Waves", "Capture", and "Extract" quest types with group progress |
  | **HudCreator** | Direct economy API integration as an alternative to command-based economy |

  All integrations are **optional** and loaded conditionally. The mod works standalone with Collect Items and Kill
  Entities quest types.

  ### Economy Compatibility
  Works with **any economy plugin** that supports server commands (Vault, EssentialsX, etc.) via the configurable
  command mode.

  ---

  ## Technical Details

  - **Server-authoritative architecture** — all quest logic runs server-side; clients maintain a read-only cache
  - **14 optimized network packets** for efficient client-server synchronization
  - **Per-player capability storage** for quest progress persistence
  - **World-level SavedData** for quest definitions and board state
  - **Secure**: All actions validated server-side before execution

  ---

  ## For Server Owners

  TaczQuestCreator is built for multiplayer servers. It provides a plug-and-play quest system that:
  - Keeps players engaged with rotating, difficulty-scaled objectives
  - Supports monetization via the premium tier system
  - Integrates with your existing economy setup
  - Gives admins full control through in-game GUIs and commands
  - Persists all data across restarts with no external database required

  ---