CustomArcheology 2.3.0

Require packetevents!
 
​

CustomArcheology
A complete archaeology and exploration framework for modern Minecraft servers.
CustomArcheology turns Minecraft archaeology into a fully configurable gameplay system. Create unique excavation sites, custom brushes, staged archaeology blocks, rare rewards, natural world generation, and progression content that fits your server.
Every archaeology block can have its own appearance, tools, brushing speed, loot table, generation rules, completed state, respawn timer, and protection behavior. Build anything from small hidden ruins to an entire server-wide exploration system.

Features
Custom Archaeology Blocks & Brushes

• Built-in 6 vanilla-style-like archelogy block., 5 vanilla-style-like archelogy item and recipes. All of them has custom texture.
• Create unlimited custom archaeology blocks with independent models, brushing stages, rewards, cooldowns, and respawn settings
• Create custom brushes with configurable efficiency, durability consumption, crafting recipes, names, lore, and usable block restrictions
• Support staged brushing progress, interruption handling, completed states, and controlled regeneration
• Keep display rewards separate from the real reward to protect hidden loot content
• Supports CraftEngine block IDs in natural-generation replacement rules

Legacy Mode & Native CraftEngine Mode

• Legacy Mode allows you keep using the proven legacy display-entity implementation without require CraftEngine plugin
• CraftEngine mode includes register real custom blocks, block states, and registered `customarcheology:brushable` behavior
• CraftEngine mode supports automatically generates CraftEngine block and tool definitions and merge resource pack from existing CustomArcheology configurations

Flexible Rewards & Custom Item Support

• Create weighted loot tables with fixed or ranged reward amounts
• Reward vanilla items, configured items, custom-plugin items, or archaeology blocks for chained content
• Direct item support for ItemsAdder, Oraxen, Nexo, MMOItems, EcoItems, EcoArmor, MythicMobs, ExecutableItems, NeigeItems, eco, and CraftEngine
• Support display items and real items independently
• Prevent reward rerolls after chunk unloads or interrupted excavation

Modern Action Engine

• Supports message, announcement, sound, potion effect, teleport, console command, player command, OP command, entity spawn, MythicMobs spawn, and chance
• Supports PlaceholderAPI plus player, reward, world, and coordinate placeholders
• Run actions when rewards are collected or trigger events immediately when rewards spawn
• Entity and MythicMobs actions search nearby for safe two-block-high spawn locations

Natural World Generation

• Generate archaeology blocks naturally with separate rules for every configured block
• Restrict generation by world, biome, height, and structures
• Support custom structure from BetterStrcuture plugin
• Use configurable placement distributions, including Gaussian-style generation
• Replace configured vanilla or CraftEngine blocks during generation
• Restore saved original block states when archaeology content is removed
• Track generated content to avoid duplicate management in loaded chunks

Protection & Server Compatibility

• Protection support for WorldGuard, Residence, GriefPrevention, Lands, HuskTowns, HuskClaims, PlotSquared, Towny, BentoBox, Dominion, and SuperiorSkyblock2
• Prevent brushing and block management inside protected areas
• Protect archaeology content from unintended breaking, explosions, pistons, and replacement conflicts
• Provide administrator bypass permissions and management commands

Resource Pack Integration

• Legacy resource-pack workflow supports ItemsAdder and Oraxen copy targets
• CraftEngine mode installs generated content directly into CraftEngine resources
• Configure block textures, brush textures, custom model data, names, lore, display scale, and visibility distance
• Use distinct model-data ranges for archaeology blocks and brushes

Built for Persistent Worlds

• Preserve selected rewards after interruptions to stop reconnect and chunk-unload rerolls
• Keep completed-block respawn timing after server restarts
• Reset unfinished brushing safely without losing block identity
• Check world state before respawning so player-placed blocks are never overwritten
• Keep legacy and CraftEngine archaeology data isolated for safe mode changes