Aethelgrad Legacy

This is the legacy Bedrock scripting core used in early Aethelgrad servers, built on Minecraft Bedrock originally Script API 2.0.0. Active development has since moved away from Bedrock scripting, and this version is released as-is for experienced developers who want to study, reuse, or adapt it.

Read Before Downloading

• Not beginner-friendly

• Not plug-and-play

• JavaScript knowledge required

• Manual code editing required

• This addon was written for a specific server setup.

• There are no config files — behavior is hardcoded in the scripts.

Included Systems

• NPC-based kits and teleports

• Hub protection and item restrictions

• Automated broadcasts

• Core command framework with permissions

• Item handling utilities (compass, cleanup)

• Cooldown logic

Core Features

• Hub Protection System

  • Configurable safe zones with damage nullification

  • Item banning (lava/water buckets, TNT, etc.)

  • Hostile mob removal

  • Admin bypass capabilities

• NPC Systems

  • Kit NPC with 60-minute cooldown starter kits

  • Teleport NPC with configurable destinations

  • Interactive UI forms for player interactions

• Player Management

  • Tag-based permission hierarchy (Owner > Admin > Moderator > Helper > Player)

  • Automatic compass distribution for navigation

  • Terms of Service display system (shows on first join, re-displays every 6 months)

• Background Services

  • Automated broadcast system with configurable message pools

  • Ground item cleaner (runs every 20 minutes with countdown)

  • Natural health regeneration (2-second intervals, 3-second combat grace)

• Utility Features

  • Debug tools (/ae:hubdebug for zone checking)

  • Combat state tracking

  • Cooldown management system

Command Registry

Hub Management Commands

• /ae:sethub

  • Sets hub center to your current location

  • Permission: Admin level (AE, admin, Admin, AEH)

• /ae:setradius

  • Sets hub protection radius

  • Permission: Admin level (AE, admin, Admin, AEh_manager)

  • ⚠️ BROKEN in API 2.4.0 - numeric arguments cause syntax errors FIXED 2.6.0

• /ae:hub (alias: /hub)

  • Teleports you to hub location

  • Permission: Anyone can use

  • Features: 5-second cooldown, combat state checking, anti-spam protection

• /ae:hubdebug

  • Checks if you're in hub protection zone

  • Permission: Anyone can use

  • Shows: Position, distances, zone status, bypass status

• /ae:banitem

  • Bans the item you're holding from the hub

  • Permission: Admin level (AE, admin, Admin, AEH)

  • Automatically removes banned items from player inventories

NPC Management Commands

• /ae:npctp

  • Sets teleport NPC destination to your current location

  • Permission: Admin level + AEN tag

  • Default destination: 19681.49, 71.00, -4748.79

System Administration Commands

• /ae:bc

  • Broadcast control system

  • Subcommands: random, reset, help

  • Permission: Broadcast managers (AE, admin, Admin, AEB)

• /ae:cleaner

  • Manual trigger for ground item cleaner

  • Permission: Admin level (AE, AEC, admin, Admin)

  • Features: 10-second countdown with warnings

Development/Test Commands

• /ae:testnumber

  • Tests numeric argument parsing for API 2.6.0 compatibility

• /ae:teststring

  • Tests string argument parsing for API 2.6.0 compatibility

Command Limitations

• API 2.4.0 Issue: Commands with numeric arguments (like /ae:setradius 50) cause syntax errors.

• Workaround: Must edit configuration files or JavaScript source directly for numeric values.

• Registration: All commands register on server startup using Bedrock's custom command registry.

Technical Details

• Minecraft: Bedrock Edition 1.21.130x - 1.26.x

• Script API: 2.6.0 (stable)

• Modules: @minecraft/server, @minecraft/server-ui

Technical Architecture

• Engine: Minecraft Bedrock API 2.6.0

• Modular Design: Bootstrap system with core, features, and services modules

• Data Storage: World dynamic properties for persistent configuration

• Error Handling: Comprehensive try-catch blocks for API limitations

• Workarounds: Multiple fixes for Bedrock API limitations

Configuration Model There is no external configuration.

• Coordinates, permissions, and logic are hardcoded

• Tags such as AE, admin, Admin are used internally

• Changes require editing JavaScript files directly

API Limitations This core contains intentional workarounds for Bedrock API 2.5.0 and 2.6.0 limitations. Some behaviors require:

• World restarts

• Reloads to apply logic

• Accepting inconsistent behavior across versions This is expected for this API level.

Installation

1. Extract into behavior_packs or double click the mcaddon

2. Enable the behavior pack in your world

3. Edit the JavaScript files to match your setup

4. Restart and test

Notes

• This project is not maintained

• No updates are planned

• No support is provided

• Intended for experienced Bedrock developers only

License LGPL-3.0 — free to use, modify, and redistribute. This is a legacy release.

Aethelgrad Discord: https://discord.gg/nEnu8a7Yjd

Do not join expecting support for this addon. This release is provided as-is. This Discord is not for addon help, bug reports, or Bedrock scripting questions. I am a server owner, not an addon support developer. This legacy core is shared for transparency, learning, and archival purposes only.