⚡ @eksses/eafe

Elytra Autonomous Flight Engine

Autonomous elytra flight for Minecraft — takeoff, climb, cruise, land. Zero config.

---

Install

npm install @eksses/eafe mineflayer

Quick Start

const mineflayer = require('mineflayer');
const { ElytraFlight } = require('@eksses/eafe');

const bot = mineflayer.createBot({ host: 'localhost', username: 'Bot' });

bot.once('spawn', () => {
  const flight = new ElytraFlight(bot);
  flight.fly(500, 500);
});

---

Features

Feature	Description
3 Flight Modes	FAST (30 m/s), MED (22 m/s), LOW (15 m/s)
Smart Landing	Auto land at safe spots with margin check
Elytra Audit	Checks durability before flight
Auto Rocket	Equips rockets automatically
Terrain Avoidance	Scans and avoids obstacles
Owner Alerts	Whisper notifications
Wander Scan	Searches for safe spots over any terrain
Retry System	Auto retry on failure

---

API

new ElytraFlight(bot, options?)

Create a flight instance.

const flight = new ElytraFlight(bot, {
  mode: 'MED',           // 'FAST' | 'MED' | 'LOW'
  cruiseAlt: 180,        // Cruise altitude (Y blocks)
  maxRetries: 3,         // Retry attempts on failure
  safety: true,          // Pre-flight checks enabled
  debug: false,          // Verbose logging (false for production)
  ownerUsername: '',     // Whisper alerts to this player
  landingMargin: 2,      // Blocks from edge of landing spot
  targetX: 0,            // Default target X
  targetZ: 0,            // Default target Z
});

flight.fly(x, z, opts?)

Fly to coordinates. Options override constructor options.

flight.fly(500, 500);
flight.fly(500, 500, { mode: 'FAST', cruiseAlt: 200 });

flight.stop(reason?)

Emergency stop. Lands bot immediately.

flight.stop();
flight.stop('out of rockets');

flight.setMode(mode)

Change flight mode.

flight.setMode('FAST');  // FAST, MED, LOW

flight.setTarget(x, z)

Set target without flying.

flight.setTarget(100, 200);

flight.setStatus(x, z)

Get flight status.

const status = flight.setStatus(500, 500);
// {
//   phase: 'CRUISE',
//   mode: 'MED',
//   pos: { x: 100, y: 180, z: 200 },
//   target: { x: 500, z: 500 },
//   dist: 350,
//   elytra: { dur: 400, count: 2, unbreaking: 3 },
//   rockets: 20,
//   flying: true
// }

flight.preflight()

Pre-flight check without flying.

const check = await flight.preflight();
// {
//   ok: true,
//   elytra: { have: 432, need: 50 },
//   rockets: { have: 20, need: 8 }
// }

flight.isFlying

Boolean — true if elytra is active.

flight.phase

Current phase: IDLE, AUDIT, TAKEOFF, CLIMB, CRUISE, LAND, WANDER, FAILED.

---

Events

flight.on('phase', (phase, msg) => {
  console.log(phase);  // TAKEOFF, CLIMB, CRUISE, LAND, IDLE
});

flight.on('stopped', (reason) => {
  console.log(reason);  // user, respawn, out of rkt
});

flight.on('error', (err) => {
  console.error(err.message);
});

---

Flight Modes

Mode	Speed	Fuel Use	Use Case
FAST	30 m/s	High	Emergency, short distance
MED	22 m/s	Medium	Default, balanced
LOW	15 m/s	Low	Long distance, fuel efficient

---

Flight Phases

AUDIT → TAKEOFF → CLIMB → CRUISE → LAND → IDLE
                         ↘ WANDER (no spot found)
                         ↘ FAILED (error)

1. AUDIT — Check elytra durability and rockets
2. TAKEOFF — Jump and activate elytra
3. CLIMB — Ascend to cruise altitude
4. CRUISE — Fly toward target
5. LAND — Spiral descent to safe spot
6. WANDER — Search for safe landing spot
7. IDLE — Landed or stopped
8. FAILED — Error occurred

---

Helpers

const { countRockets, getElytraSummary } = require('@eksses/eafe');

const rockets = countRockets(bot);        // Number
const elytra = getElytraSummary(bot);     // { totalDurabilityAcrossAll, count, bestUnbreaking }

---

Examples

Example	Description
basic.js	Simple flight
demo.js	Chat commands
delivery.js	Multi-stop delivery
waypoint-travel.js	Location loop
rescue-bot.js	Player rescue
multi-bot.js	Fleet control
inventory-transfer.js	Chest transfer
api-demo.js	API showcase

---

Requirements

• Node.js ≥ 16.0.0
• mineflayer ≥ 4.0.0
• Bot must have elytra equipped in chest slot
• Bot must have firework rockets in inventory

---

License

MIT