Eureka Control Keys

Control Eureka ships with reusable key items instead of opening the helm GUI.

Important: Always back up your world before installing, updating, removing, or using this mod.
This is an unofficial addon and should be used entirely at your own risk.

About

Eureka Control Keys is an unofficial utility addon for Eureka! Ships! and Valkyrien Skies.

It adds three reusable key items that allow players to:

Assemble a ship
Align an assembled ship
Disassemble a ship

Each action can be triggered directly from a Eureka ship helm without opening the helm GUI.

This addon was originally created as a workaround for Vivecraft environments where the Eureka helm interface may not appear correctly or may be difficult to operate in VR.

Vivecraft is not required. The keys can also be used in standard non-VR Minecraft.

The addon does not replace Eureka's ship system. It simply provides an alternative way to trigger Eureka's existing ship-control functions.

Features

Assembly Key

Use the Assembly Key on a Eureka ship helm to assemble the connected structure into a ship.

Alignment Key

Use the Alignment Key on the helm of an assembled ship to trigger Eureka's ship alignment function.

Disassembly Key

Use the Disassembly Key on the helm of an assembled ship to disassemble the ship.

Key Properties

All three keys:

Have no durability
Are not consumed when used
Have a maximum stack size of one
Can be found in the Tools and Utilities creative inventory tab
Include English and Japanese item names
Use Eureka's existing ship functions

How to Use

Craft or obtain the required control key.
Hold the key in your hand.
Sneak while looking directly at a Eureka ship helm.
Right-click or interact with the helm.
The corresponding ship action will be executed by the server.

The key must be used directly on a Eureka ship helm. Using it on another block will not activate a ship function.

Crafting Recipes

All three keys use the following recipe pattern:

S R S
R X R
S R S

Where:

S = Stone
R = Redstone Dust
X = Material that determines the key type

Assembly Key

The center material is a Gold Ingot.

Stone          Redstone Dust   Stone
Redstone Dust  Gold Ingot      Redstone Dust
Stone          Redstone Dust   Stone

Alignment Key

The center material is a Compass.

Stone          Redstone Dust   Stone
Redstone Dust  Compass         Redstone Dust
Stone          Redstone Dust   Stone

Disassembly Key

The center material is an Iron Ingot.

Stone          Redstone Dust   Stone
Redstone Dust  Iron Ingot      Redstone Dust
Stone          Redstone Dust   Stone

Known Issue: `/vrship` Commands

The /vrship commands included in the current version are affected by a known issue and do not function correctly.

Do not rely on these commands for ship operations. Use the three key items directly on the Eureka ship helm instead.

The affected commands include:

/vrship
/vrship help
/vrship keys
/vrship assemble
/vrship align
/vrship disassemble
/vrship locate

The key-based controls are the intended and recommended way to use the current version of the mod.

Minecraft's standard /give command is not affected by this issue.

Item IDs

vr_eureka_disassembler:assembly_key
vr_eureka_disassembler:alignment_key
vr_eureka_disassembler:disassembly_key

The keys can be obtained with the following commands:

/give @s vr_eureka_disassembler:assembly_key
/give @s vr_eureka_disassembler:alignment_key
/give @s vr_eureka_disassembler:disassembly_key

Requirements

Eureka Control Keys requires:

Minecraft 1.20.1
Minecraft Forge 47.x
Valkyrien Skies
Eureka! Ships!

Vivecraft is the main reason this addon was created, but it is not required for the key controls to function.

Installation

This mod must be installed on both the client and the server.

Install Minecraft Forge for Minecraft 1.20.1.
Install Valkyrien Skies.
Install Eureka! Ships!
Create a complete backup of your world.
Place the Eureka Control Keys JAR file in the mods folder.
For multiplayer or dedicated servers, install the same mod version on both the client and server.

Do not install multiple versions of Eureka Control Keys at the same time.

Testing the mod in a separate test world before using it in an important world is strongly recommended.

Multiplayer

For multiplayer and dedicated servers:

The mod must be installed on the server.
Players connecting to the server must also have the mod installed.
The client and server should use the same version.
Ship actions are executed and validated by the server.

Backup and Data Warning

Always create a complete backup of your world before installing, updating, removing, or using this mod.

A bug, crash, incompatibility, interrupted server process, or unexpected interaction with another mod could potentially result in:

Missing or duplicated blocks
Damaged ship structures
Lost items
World or chunk corruption
Server crashes
Other unexpected damage to Minecraft data

Store important backups separately from the active Minecraft world or server folder.

Compatibility

This addon is designed for:

Minecraft 1.20.1
Forge 47.x
Eureka! Ships!
Valkyrien Skies
Vivecraft, when applicable

Compatibility with other Minecraft versions, mod loaders, Eureka versions, Valkyrien Skies versions, Vivecraft versions, servers, and modpacks is not guaranteed.

This is an unofficial addon and is not affiliated with or endorsed by Mojang, Microsoft, Vivecraft, Eureka, Valkyrien Skies, CurseForge, or their respective developers.

Reporting Issues

Bug reports are welcome, although fixes and continued updates cannot be guaranteed.

When reporting an issue, please include:

Minecraft version
Forge version
Eureka version
Valkyrien Skies version
Vivecraft version, when applicable
Eureka Control Keys version
Single-player or multiplayer
Relevant latest.log or crash report
A description of what happened immediately before the issue occurred

Providing this information may make it easier to identify the cause of the problem.

AI-Assisted Development

This project was developed with the assistance of artificial intelligence tools.

AI tools were used to help write, review, debug, and revise parts of the Java source code and Forge project structure.

The project's purpose, required behavior, testing process, crash analysis, and final implementation decisions were directed and evaluated by the author through repeated testing in a Forge, Vivecraft, Eureka, and Valkyrien Skies environment.

AI-assisted code may contain errors or unexpected behavior. Please follow the backup recommendations above.

Disclaimer

Eureka Control Keys is an unofficial and experimental addon.

The addon does not replace or redistribute Eureka or Valkyrien Skies. It calls ship-control functions provided by the installed Eureka mod.

Use this mod entirely at your own risk. The author is not responsible for corrupted worlds, lost progress, damaged ships, lost items, server problems, software conflicts, or other losses resulting from the installation or use of this addon.

Eureka Control Keys

About

Features

Assembly Key

Alignment Key

Disassembly Key

Key Properties

How to Use

Crafting Recipes

Assembly Key

Alignment Key

Disassembly Key

Known Issue: /vrship Commands

Item IDs

Requirements

Installation

Multiplayer

Backup and Data Warning

Compatibility

Reporting Issues

AI-Assisted Development

Disclaimer

Known Issue: `/vrship` Commands