QuestLines Claims

QuestLines Claims

A complete land management system for Hytale servers — combining player claims, admin regions, and rent/buy plots into a single, UI-driven, database-backed plugin.

Designed to integrate with the QuestLines suite while remaining fully standalone.

Overview

QuestLines Claims provides three layers of land control:

• Player Claims
  Chunk-based land ownership managed through an in-game map UI. Claims are contiguous and visually distinct with unique colors.
• Admin Regions
  Staff-defined rectangular areas for spawn protection, events, or controlled zones.
• Rent & Buy Plots
  Economy-integrated regions that players can lease or purchase, with automated Prefab resets on expiration.

All systems are fully managed through in-game UI — no manual configuration required.

Core Features

Player Claims

• Claim land using a configurable 15×15 chunk map UI (grid must be odd-sized)
• Claims are contiguous by design:
  • New chunks must connect
  • Splitting a claim is automatically prevented
• Each claim includes:
  • Unique, randomly generated HSV-based color
  • Editable display name
• Support for multiple claims per player
• Configurable minimum distance between different players’ claims
• Permission-based claim limits:
  • questlinesclaims.claim.chunks.N (stackable)
  • Admin override via /claim addchunks
• Automatic claim decay for inactive players (configurable, default 30 days)

Admin Regions

• Create regions using a two-point wand selection with live visual feedback
• Priority system for overlapping regions
• One-click Expand-Y for full vertical protection
• Configurable default permissions for non-members
• Advanced per-flag exclusion patterns:
  • Allow specific blocks/items even when a flag is denied
  • Supports wildcard matching
• Full member and permission management

Rent & Buy Plots

• Convert any admin region into a rentable or purchasable plot
• Optional economy integration via VaultUnlocked (auto-detected)
• Fully configurable:
  • Pricing
  • Lease duration
  • Warning intervals (default: 7d, 1d, 1h)
• Lease lifecycle:
  • Missed payment triggers grace period (default 3 days)
  • Region is locked during grace
  • After expiry → automatic Prefab reset
• Optional pro-rated refunds
• Dedicated browser UI with filtering and detailed plot info

Permissions System

Supports 12 granular flags, configurable per member, region, or wilderness:

• BUILD — place blocks
• BREAK — break blocks
• INTERACT — general interaction
• CONTAINER — storage & crafting access
• DOOR — door usage
• PVP — player damage
• FRIENDLY_FIRE — PvP between members
• ENTRY — allow physical entry (enforced live)
• PORTAL — teleport/portal usage
• SIT — seating interactions
• EXPLOSIONS — explosion block damage
• SPAWN — mob spawning

Wilderness Rules

• Global flag set for unclaimed land behavior
• Per-player overrides supported
• Defaults allow unrestricted interaction

World Integration

World Map Overlay

• Displays claim and region boundaries directly on the in-game map
• Configurable opacity

Boundary Titles

• Players receive visual titles when crossing regions
• Color-coded based on destination claim/region

Protection Coverage

Built on Hytale’s ECS for comprehensive enforcement:

• Block placement, breaking, and damage
• Interaction with blocks, entities, and crafting systems
• Container access and processing systems
• Portal and teleporter usage
• PvP and friendly-fire handling
• Item pickup control
• Explosion damage handling
• Mob spawning control
• Live entry enforcement (players are pushed out if not permitted)

Notifications

• Real-time toast notifications for events (warnings, locks, resets)
• Offline message queue with delivery on login

Engine-Native Schematics

• Uses Hytale’s Prefab API for region snapshots and resets
• No custom serialization or external tooling required

Migration / Importing

Built-in support for importing existing claim data:

• SimpleClaims (SQLite)
• WiFlowsClaims (JSON)

Command:

Commands

Permissions

• questlinesclaims.admin
  Full administrative control (regions, wand, bypass, commands)
• questlinesclaims.claim.use
  Allows claim usage and UI access (default: enabled)
• questlinesclaims.claim.chunks.N
  Grants additional claim capacity (stackable)

Storage

All runtime data is stored in a database:

• SQLite (default, no setup required)
• MySQL
• MariaDB

Disk usage is limited to:

Optional Dependency

• VaultUnlocked
  Required only for rent/buy functionality
  Automatically detected at runtime

Compatibility

• Fully standalone
• Designed for seamless integration with the QuestLines plugin suite