PROJECT: NEXUS

🚀 Marketing / Showcase Version (for store page, trailer, social posts)

PROJECT: NEXUS — High-Tech Combat for Minecraft Bedrock

Step into a sci‑fi survival experience built entirely on Minecraft Bedrock’s Script API and content tools. PROJECT: NEXUS replaces boring swords and bows with a full arsenal of energy weapons, power armor, and a rideable combat mech — all with custom projectiles, particles, sounds, and gameplay mechanics.

⚡ High-Tech Weaponry

Unleash a diverse arsenal where every weapon feels unique:

Photon Thrower – Energy blaster whose projectile “remembers” durability; kills grant brief Regeneration.

Electro Dagger – Hybrid melee/thrown weapon you can launch and retrieve.

Phase Blaster – Automatic blaster with distance-based damage and Slowness on hit.

Static Chargers – Multi-directional energy volleys for crowd control.

Plasma Pulse – Continuous plasma fire for sustained pressure.

Flux Equalizer – Premium energy cannon with custom particles, sound, and fire cycle.

Fusion Axe – High-damage axe that also chops wood efficiently.

Spectral Scythe – Ethereal scythe with spectral effects and strong melee presence.

Static Slicer – Electrified blade with shock visuals on every strike.

🛡️ Next-Gen Armor Systems

Two full armor lines redefine protection and mobility:

Mega Armor – High-durability set with per-piece bonuses (Night Vision, Health Boost, Strength, Slow Falling) and stacking Resistance when wearing multiple pieces.

Ultra Armor – Endgame “power armor” with extreme durability and full-set bonuses: Resistance, Speed, and Sneak-to-fly movement using Levitation + forward push.

🤖 Rideable Mech Robot

Pilot a giant combat mech with 50 HP, knockback resistance, custom animations, and a dedicated weapon system:

Walk, jump, and land with unique motion and sound.

Fire Mech Laser projectiles via a dedicated event (loth_sw:mech_shoot).

Fully animated cockpit experience — not just a mob, but a vehicle.

💎 Progression & Resources

Follow a clear tech tree:

World generation → Mega/Ultra Crystals → Mega/Ultra Shards → Craft weapons & armor → Upgrade your loadout.

✨ Immersive Combat

Every hit feels impactful thanks to:

Custom particles: laser beams, trails, sparks, slashes, mech stomps, and more.

Dedicated sound effects: laser variants, cannon fire, mech movement, robot hits.

A built-in Guidebook that auto-gifts on first join, explaining systems and recipes.

PROJECT: NEXUS is designed for servers and single-player worlds that want futuristic combat without leaving Minecraft’s vanilla feel.

📘 Technical / README Version (for GitHub, docs, or detailed description)

PROJECT: NEXUS – Technical Overview

A Minecraft Bedrock addon introducing a high-tech combat system with custom weapons, armor tiers, a rideable mech, resource-based progression, and extensive Script API usage for durability, projectiles, particles, and audio.

1. Weapon Arsenal

The addon provides multiple energy and melee weapons, each with distinct projectile behavior and combat roles.

1.1 Energy Weapons

Photon Thrower

Type: Ranged energy weapon.

Behavior: Fires a projectile in the look direction.

Durability Sync: Projectile stores the weapon’s durability state; upon retrieval, the weapon can be respawned with matching durability.

On Hit: Electrical VFX + laser SFX.

On Kill: Grants short-duration Regeneration to the attacker.

Electro Dagger

Type: Hybrid melee/thrown weapon.

Behavior: Can be thrown as a projectile and retrieved after use.

Playstyle: Enables both close-range and mid-range engagements.

Phase Blaster

Type: Automatic energy blaster.

Behavior: While held, continuously spawns projectiles.

Damage Scaling: Damage decreases at very close range; higher damage when no close target is detected.

Debuff: Applies Slowness on hit for crowd control.

Static Chargers

Type: Multi-angle energy weapon.

Behavior: Continuously fires projectiles that spawn at varying positions around the player, simulating a multi-directional turret.

Use Case: Effective against groups.

Plasma Pulse

Type: Continuous plasma cannon.

Behavior: While held, JavaScript logic maintains a firing loop, emitting plasma projectiles in cycles.

Role: Suppressive fire / sustained DPS.

Flux Equalizer

Type: High-tier energy cannon.

Behavior: Cyclic projectile emission while held.

Features: Custom projectile entity, particle set, and audio; designed to feel like a true energy weapon rather than a reskin.

1.2 Melee Weapons

Fusion Axe

Base Damage: 6

Max Durability: 800

Enchantable: Yes

Special: Optimized breaking speed for wood-type blocks; durability managed via Script API.

Role: Hybrid tool/weapon for players who prefer loadout efficiency.

Spectral Scythe

Base Damage: 6

Max Durability: 800

Enchantable: Yes

Special: Custom particle and sound effects on hit; “spectral” visual theme.

Role: High-style melee weapon with strong presence.

Static Slicer

Base Damage: 5

Max Durability: 800

Enchantable: Yes

Special: Electric VFX and SFX on hit for clear combat feedback.

Role: Fast, electric-themed melee blade.

2. Armor Systems

Two armor lines provide layered progression and powerful set bonuses.

2.1 Mega Armor

Pieces: Mega Helmet, Mega Chestplate, Mega Leggings, Mega Boots.

High base protection and very high durability.

Per-piece effects:

Helmet: Grants Night Vision.

Chestplate: Grants Health Boost (increases max HP).

Leggings: Grants Strength (increases attack damage).

Boots: Provides Slow Falling under specific conditions (e.g., falling from height).

Set Bonus Logic: Script checks the number of equipped Mega Armor pieces; more pieces = stronger Resistance effect.

Design Goal: Not just defense, but a character upgrade system.

2.2 Ultra Armor

Pieces: Ultra Helmet, Ultra Chestplate, Ultra Leggings, Ultra Boots.

Durability:

Helmet: 600

Chestplate: 700

Leggings: 650

Boots: 550

Per-piece effects:

Chestplate: While sneaking, applies forward push + Levitation, enabling aerial movement.

Leggings: Grants Haste.

Boots: Grants Jump Boost.

Full Set Bonus:

Resistance

Speed

Enhanced aerial mobility (fly-like movement)

In-game hint: “Sneak to fly!”

Design Goal: Functions as a Power Armor system rather than pure defense.

3. Resources & Progression

Addon introduces two special resources integrated via world generation features:

Mega Crystal

Ultra Crystal

These are obtained through custom features and feature_rules. They are processed into:

Mega Shard – Core material for Mega Armor.

Ultra Shard – Core material for many high-tech weapons and Ultra Armor.

Progression Flow:

Explore world → find Crystals.

Craft Shards.

Craft weapons and armor.

Upgrade combat power.

This creates a clear, survival-friendly tech tree.

4. Mech Robot

A signature feature: a rideable combat mech.

4.1 Mech Properties

Health: 50 HP

Knockback Resistance: High

Size: Larger than player

Mobility: Walk, jump, land; custom animations for each.

Riding: Dedicated seat; player can enter and control the mech.

Animations: Separate rig/animation set for movement, shooting, jumping, landing, and destruction.

4.2 Weapon System

Weapon: Mech Laser.

Event: Firing handled via custom event loth_sw:mech_shoot in Script API.

Projectile: Dedicated entity with its own animation and VFX.

Audio: Unique firing and impact sounds.

The mech behaves more like a combat vehicle than a standard mob.

5. Durability System

All weapons and armor use custom durability logic, primarily via Script API.

Most energy weapons: 800 max durability.

Script intercepts usage events to reduce durability.

Unbreaking Support: Script checks the item’s Unbreaking level to calculate chance to avoid durability loss, allowing vanilla enchantments to interact with addon weapons.

6. Particles & Combat Feedback

Extensive custom particle system enhances visual clarity:

Laser Beam, Laser Glow, Laser Trail

Lightning, Lightning Hit, Sparks

Slash, Ring, Power

Mech Stomp, Mech Trail, Boulder Effects

On hit, weapons trigger corresponding particles and sounds, making combat significantly more immersive than vanilla.

7. Audio System

Dedicated sound set for weapons and mech:

Multiple laser variants: laser cannon, laser zap, laser heavy

Melee: swing

Mech: jump, landing, walking, loading

Impacts: robot hit, etc.

This ensures each engagement has unique audio feedback instead of reusing vanilla sounds.

8. Guidebook

On first join, players automatically receive a Guidebook.

Custom texture and multi-page layout.

Explains:

Weapon behaviors

Armor bonuses

Resource progression

Mech controls

This lowers the learning curve for new players given the addon’s complexity.

Note:

Enable all experimental features

Suitable for Minecraft version 1.21.50 or later.