Nomadic Player Companion (NPC) — Inspired by Phantasy Star Online's Mag, for Minecraft Bedrock.

Bring the iconic Mag companion mechanic from Phantasy Star Online into Minecraft, reimagined as your own Nomadic Player Companion. Your NPC is a small floating Drone companion that follows you everywhere, grows stronger the more you feed it, fights alongside you once it's strong enough, and can even evolve into one of five classic PSO-inspired forms — Bastion, Zephyr, Talon, Oracle, or the legendary balanced Nomad.

This isn't a reskinned pet. It's a full stat-growth system inspired by PSO's original Mag mechanic, rebuilt from the ground up for Minecraft: raise its stats, watch those stats boost you in real time, unlock a ranged attack,  recolor it any of 16 colors, and even trade it to other players in your world as an item that hatches back into the exact same NPC!

---

V3.0.4

Whats New

• Physical ram attack. About 1 in 4 Chance of the companion's attacks are charges and rams to the target directly instead of firing a photon bullet all the time. — same damage, same cooldown, same line-of-sight requirement, just a different delivery.

• A chargeable AoE Photon Blast that auto-fires on the NPC's next attack once its meter fills. Hits every monster within 10 blocks for 10× normal damage (walls don't block it) and heals every nearby player with Regeneration V for 10 seconds.

  Charge sources:

  +2% per NPC bullet or ram hit

  +2% per hit you land on an enemy

  +1% per hit you take

  In-game Photon Blast meter:

  A live actionbar display, shown for your main NPC once it's evolved.

• 0% PB [- - - - - - - - - -] 0%

• 10% PB [■- - - - - - - - -] 10%

• 20% PB [■■- - - - - - - -] 20%

• 30% PB [■■■- - - - - - -] 30%

• 40% PB [■■■■- - - - - -] 40%

• 50% PB [■■■■■- - - - -] 50%

• 60% PB [■■■■■■- - - -] 60%

• 70% PB [■■■■■■■- - -] 70%

• 80% PB [■■■■■■■■- -] 80%

• 90% PB [■■■■■■■■■-] 90%

• 100% Photon Blast READY! (next attack)

Changes

• Performance improvements. Reduced redundant entity lookups across the addon's tick loops — the legacy-save migration check now only runs once per player instead of on every single lookup, and the photon-bullet firing check was folded into the main movement loop instead of running as a separate, duplicate query. Net effect: roughly half the per-player entity queries per second, which should meaningfully reduce lag with multiple players/companions active. Disabled unnecessary physics overhead (world collision, piston pushability) on the companion entity — it's always directly re-positioned by script every tick, so these were pure recurring cost with no actual effect. 

The periodic 10-second snapshot (which backs up a companion's stats/color/evolution/etc. to the player) now skips writing entirely if nothing has actually changed/Updated since the last snapshot, instead of rewriting the same values every time.

Fixed

 

• NPCs set to Stay no longer freeze in place — idle bob, feeding bob, and random idle fidgets (spin/wiggle/bob) now keep playing while staying put, same as while following.

---

Getting Started

The moment you join a world with this addon active, you'll receive two items:

• NPC Spawn Egg — use it to summon your NPC. It'll appear floating just off your shoulder and begin following you immediately.

• NPC Menu — your control item. Use it anytime, anywhere, to open your NPC's control screen. You don't need to be looking at your NPC or standing near it.

Your NPC has infinite effective health — it cannot be killed, by anything. If it's ever destroyed, unloaded too far away, lost across a dimension change, or you die, it automatically re-forms right beside you with everything (stats, XP, color, evolution) fully intact. An Eye of Ender explosion marks the spot when it reappears.

If your NPC ever gets stuck somewhere or seems to have vanished, sneak and use the NPC Menu item to force an instant re-summon.

---

The NPC Menu

Using the NPC Menu item opens a live preview screen showing your NPC's actual in-game model, with the following options:

 

Button	What it does
Feed NPC	Opens the feeding menu (paginated across a few screens) — pick an item from your inventory to feed your NPC
Stat Viewer	Shows your NPC's current DEF / POW / DEX / MIND, XP progress toward each stat's next point, total level, and evolution status
NPC 2	NPC 2 button in place of the old direct "Change Color" button (color moved into Toggles — see below). It opens a second menu, fully mirroring the first: Feed NPC 2, Stat Viewer 2, Toggles 2, Unequip NPC 2 Buttons.
(New) Toggles	on/off switches — Stay/Follow, Light On/Off, ATK On/Off to turn off Photon Bullet shots Light Low/High toggle — Low (soft glow, default) and High (full brightness), remembered across respawns and trades. Change Color: Recolor your NPC to any of 16 colors (see below)
Unequip NPC	Turns your NPC into a tradeable item (see Trading below) — asks for confirmation first
Guide	An in-game reference covering everything below, including the full feeding chart and evolution rules

Toggles submenu

• Stay/Follow — tells your NPC to wait right where it is instead of following you, or resume following. Great for base-building or screenshots. This is a short-term positioning tool, not a saved setting: it automatically switches back to following after any respawn (death, dimension change, resummon, rejoining).

• Light On/Off — gives your NPC a soft glowing light that follows it wherever it goes (see Companion Light below). Unlike Stay/Follow, this preference is remembered — it survives every respawn and travels with your NPC if you trade it away as an egg.

Companion Light

Turn on Light in the Toggles submenu and your NPC starts carrying its own glow with it. As it moves, the light moves with it — the area around your NPC lights up, and the spot it just left goes dark again a moment later. It only ever lights up wherever your NPC currently is.

A couple practical notes:

• The light only settles into open space — it will never overwrite a block you've placed. If your NPC is ever wedged somewhere with no free air pocket, it simply goes dark until it moves somewhere open again.

• Your light preference (On/Off, Low/High) is remembered across respawns, dimension changes, and resummons, and is saved directly onto a traded NPC Egg — hatch that egg later, or hand it to someone else, and the light setting comes with it.

---

Stats & Feeding

Your NPC has four stats, each inspired directly by PSO's original MAG system:

 

Stat	Player Effect
DEF	Resistance
POW	Strength
DEX	Speed
MIND	Health Boost

Each stat ranges from 0 to 100, with a combined total cap of 200. Once your NPC hits level 200, it can't be fed anymore — it's maxed out.

How feeding actually works

Feeding an item doesn't raise a stat directly. Instead, it adds XP (0–100) toward that stat. Every time a stat's XP fills past 100, it resets to 0 and the stat itself gains +1 real Level. Some items raise one stat while slightly lowering another — just like the real MAG feeding mechanic from PSO.

You can feed your NPC 3 times, then it needs 3 minutes 30 seconds to recharge before you can feed it again (all 3 charges come back together). When your NPC becomes feedable again, you'll hear a distinct "ready" ding.

Feeding Chart

Items are balanced by how hard they are to obtain — common, renewable items give modest boosts with a small tradeoff; rarer items give bigger and/or cleaner boosts. Diamond is the best all-around item, boosting all four stats at once with zero downside.

 

Item	DEF	POW	DEX	MIND
Wheat Seeds	+10	—	—	+10
Bread	+15	+15	-5	—
Sugar	—	—	+20	-8
Baked Potato	+15	+25	-8	—
Lapis Lazuli	—	-5	—	+20
Redstone Dust	—	-8	—	+30
Cooked Steak / Porkchop	+15	+32	-10	—
Golden Carrot	+20	+20	—	—
Amethyst Shard	—	-10	—	+42
Diamond	+20	+20	+20	+20

(All values are XP added toward that stat, not instant stat Levels.)

Passive stat effects

Every stat Level matters: for every 10 real Levels in a stat, your NPC grants you +1 tier of that stat's effect (up to tier 10 at 100 Levels). A stat sitting at exactly 0 gives no bonus at all — it only starts contributing once a stat has hit Level 1.

I Doubled the tier granularity. Instead of 5 tiers (each worth 20 stat points), you now have 10 tiers (each worth 10 stat points).

(New) Buffed Tier Comparison Table

 

 

 

Stat Value (Levels)	Old Tier	New Tier
1–9	0	0
10–19	0	1
20–29	1	2
30–39	1	3
40–49	2	4
50–59	2	5
60–69	3	6
70–79	3	7
80–89	4	8
90–99	4	9
100	5	10

Every 60 seconds, your NPC applies your current tiers to you as buffs lasting 5 minutes per application:

• DEF → Resistance

• POW → Strength

• DEX → Speed

• MIND → Health Boost (each tier is one full vanilla Health Boost level — +2 hearts per tier, since that increment is fixed by Minecraft itself)

---

Photon Bullet — Ranged Combat

Once your NPC's total level reaches 5, it unlocks its own ranged attack: a photon bullet, fired automatically at the nearest hostile mob within 10 blocks every 30 seconds. It only ever targets actual monsters — zombies, skeletons, creepers, and the like — never passive or neutral mobs, and never other players.

Photon Bullet damage range Changed: From 3–8 to→3–13, since max POW tier is now 10, not 5 (damage = 3 + POW tier).

Photon Blast

Photon Blast (PB) is your main NPC's special move: a big burst that hits every monster around it and heals nearby players.

Requirements

• Main NPC only. NPC 2 cannot use Photon Blast.

• The NPC must be evolved. The meter does not charge before evolution.

• ATK must be On in the Toggles menu. If ATK is off, the NPC never attacks, so a ready Photon Blast never fires.

Charging the meter

The meter appears just above your hotbar while it charges, for example at 50%:

PB [■■■■■-----] 50%

 

Event	Meter gain
Your NPC lands a bullet or ram hit	+2%
You land a hit on an enemy	+2%
You take damage	+1%

At 100% the readout changes to Photon Blast READY! The meter then stays full until the next attack fires.

When it fires

Once the meter is full, your NPC's next attack becomes a Photon Blast instead of a bullet or ram. That means it waits for the usual attack timing (set by DEX) and needs a monster within 10 blocks that it can see. After the blast, the meter resets to 0%.

What it does

• Hits every monster within 10 blocks for 10x your NPC's normal attack damage, with no line-of-sight needed (walls don't block it).

• Gives every player within 10 blocks (you included) Regeneration V for 10 seconds.

• Plays a ring of particles at the 10-block edge and the Photon Blast sound.

Damage chart

Damage scales with your NPC's POW tier (1 tier per 10 POW Levels, max tier 10 at 100). The Photon Blast number is per monster hit. 2 damage = 1 heart.

 

POW Levels	POW Tier	Bullet / Ram	Photon Blast (per monster)
0–9	0	3	30
10–19	1	4	40
20–29	2	5	50
30–39	3	6	60
40–49	4	7	70
50–59	5	8	80
60–69	6	9	90
70–79	7	10	100
80–89	8	11	110
90–99	9	12	120
100	10	13	130

These are the damage values dealt. A target's armor or resistance effects may reduce what it actually loses. For scale, common 20-HP mobs (zombies, skeletons, creepers) go down to a single Photon Blast even at POW tier 0.

The bullet itself is a small teardrop-shaped projectile that always matches your NPC's current color — recolor your NPC and every bullet it fires afterward matches automatically.

Photon Bullet fire rate reference

DEX tier now controls how often each NPC fires — 1.5 seconds faster per tier, from 30s down to 15s at max DEX. This applies independently per NPC, based on that NPC's own DEX.

 

DEX Tier	Fire Interval
0	30.0s
1	28.5s
2	27.0s
3	25.5s
4	24.0s
5	22.5s
6	21.0s
7	19.5s
8	18.0s
9	16.5s
10	15.0s

---

Evolutions — Inspired by PSO's Rarest Evolutions

This is the addon's signature feature. Once your NPC's total level reaches 20, it evolves — permanently, and only once, like PSO's rare fourth-tier MAG evolutions:

 

Condition	Evolution
All 4 stats at level 5	Nomad
DEF highest	Bastion
DEX highest	Zephyr
POW highest	Talon
MIND highest	Oracle

Nomad is checked first, so feeding evenly early on will likely lock that in before any single stat pulls ahead. To chase one of the specialized forms instead, keep at least one stat under level 5 so Nomad's condition never triggers, and make sure your favored stat stays the highest of the four by the time you hit total level 20.

Evolving only changes your NPC's model — stats, tier effects, and the photon bullet all keep working exactly the same afterward. You can still change your NPC's color anytime, evolved or not; recoloring never resets or undoes an evolution.

---

Trading NPCs

Your NPC isn't locked to you forever. Using Unequip NPC in the menu turns your active NPC into a brand-new unstackable NPC Egg item — with its stats, XP, color, and evolution all saved directly onto the item itself. The egg's name and lore show a readable summary (evolution, level, full stat breakdown, and color) so anyone holding it can see exactly what they've got before hatching it.

Using an NPC Egg hatches it — spawning an NPC that restores everything stored on that item, owned by whoever used it. Since all of that data travels with the item itself, this means you can genuinely trade NPCs between players: drop the egg in a chest, hand it off, whatever — hatching it on the other end reproduces the exact same NPC, evolution included.

This works between any players sharing the same world or server — it's a real item, so it moves however items normally move between players in Minecraft (chests, drops, trades). It can't travel between separate, unconnected world saves; there's no cross-world transfer.

A few safety notes:

• Hatching is blocked if you already have an active NPC, so you can't accidentally overwrite one.

• Unequipping clears your own saved backup data, so the NPC's "identity" now lives only in that egg — you can't unequip it and also keep a duplicate.

• Your NPC won't be auto-summoned again (on death, dimension change, rejoining, or force-resummon) while you're holding an unhatched egg — you have to deliberately hatch it to get an NPC back.

---

Second NPC — Quick Guide

Added in v2.6.9

How you get a second NPC

There are exactly two ways — no others:

1. Trade with another player. Receive an NPC Egg (blank or data-carrying) from someone else in your world.

2. Birth one by feeding your first NPC to level 200. The moment any of your NPCs first reaches total level 200, it births a brand-new NPC Spawn Egg into your inventory, with the message "Your NPC has birthed another one!" This fires exactly once per NPC — right when it crosses into level 200.

Once you have an unused egg in hand, using it while your first NPC is already active spawns a second, independent companion on your right shoulder — your original NPC stays on the left, exactly where it's always been.

The 2-NPC limit

You can have at most 2 NPCs at once. If you try to use a third egg — whether a blank Spawn Egg or a data-carrying Egg — nothing happens and the egg simply stays in your hand. It isn't consumed; it just doesn't do anything until you free up a slot (by unequipping one of your two NPCs).

The NPC 2 menu

The main NPC Menu now has an NPC 2 button in place of the old direct "Change Color" button (color moved into Toggles — see below). It opens a second menu, fully mirroring the first:

 

Button	What it does
Feed NPC 2	Feed your second NPC — same feeding chart, same cooldown rules, entirely independent of your first NPC's feed cycle
Stat Viewer 2	Shows your second NPC's DEF/POW/DEX/MIND, XP, evolution, and total level
Toggles 2	Same five toggles as your first NPC — Stay/Follow, Light On/Off, Light Low/High, ATK On/Off, and Change Color — but scoped entirely to your second NPC
Unequip NPC 2	Turns your second NPC into its own tradeable egg, independent of your first

The NPC 2 button does nothing until you actually have a second NPC. If you click it before then, you'll get a message telling you how to get one — no menu opens, no error, just a heads-up.

What's independent vs. shared

Your two NPCs are entirely separate companions — nothing is shared between them:

• Separate stats, XP, evolution, color, light, and ATK preferences

• Separate feed cooldowns (charges recharge independently)

• Each fires its own photon bullet on its own DEX-based schedule

• Buffs do NOT add together. Both NPCs call the same underlying Minecraft effect (e.g. Resistance) on you, and Minecraft doesn't stack two applications of the same effect - it only keeps the stronger one. So for each stat, you only benefit from whichever of your two NPCs currently has the higher tier in that stat; the weaker one contributes nothing extra for that particular effect. There's no benefit to leveling the same stat on both NPCs equally - you're better off specializing them differently so each one is your "strongest" source for a different stat.

• Unequipping one has no effect on the other

• Losing one (death, dimension change, etc.) doesn't affect the other — each is restored independently

---

Compatibility & Notes

• Requires Bedrock 1.21+ and the Beta APIs experimental toggled OFF.

• Works in Survival and Creative.

• Multiplayer-friendly — every player gets their own independent NPC.

• Your NPC correctly follows you into custom dimensions added by other addons (still a bit buggy in custom dimensions), not just the Overworld/Nether/End — it's driven by wherever you actually are, not a fixed dimension list.

• No known conflicts with other behavior packs; the addon does not modify vanilla mobs, items, or blocks.

• This addon does not affect hunger, food, or exhaustion in any way.

---

Credits

The original PSO Mag mechanics, stat system, are inspired by Phantasy Star Online, originally developed by Sonic Team / Sega. This is a fan-made, non-commercial tribute built entirely from scratch for Minecraft Bedrock — no original PSO assets, code, or files are included.