[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

  —