Eureka Control Keys

Eureka Control Keys is an unofficial utility addon for Eureka! Ships! and Valkyrien Skies that lets players assemble, align, and disassemble ships by using special key items directly on an Eureka ship helm.

Important: Back up your world before installing or using this mod.

This is a small experimental addon developed by an individual with the assistance of AI tools. The author has limited mod-development experience and may not have the technical ability to diagnose or fix every bug, crash, incompatibility, or data-related problem.

I sincerely apologize in advance if you experience any problems while using this mod.

Why This Mod Was Created

This addon was originally created to work around a compatibility issue between Vivecraft and the Eureka ship helm interface.

In some Vivecraft environments, the Eureka helm GUI may fail to appear, may be difficult to operate in VR, or may otherwise prevent players from accessing important ship functions. Instead of modifying Vivecraft or replacing Eureka’s ship system, this addon provides an alternate control method that bypasses the helm GUI.

The ship itself is still assembled, aligned, and disassembled by Eureka. This addon simply gives the player another way to trigger those existing functions.

Although the mod was designed primarily for Vivecraft users, it can also be used without VR by players who prefer item-based ship controls.

Features

The mod adds three reusable key items:

Assembly Key

Use this key on an Eureka ship helm to assemble the connected structure into a ship.

Alignment Key

Use this key on an assembled Eureka ship helm to trigger Eureka’s ship alignment function.

Disassembly Key

Use this key on an assembled Eureka ship helm to trigger Eureka’s ship disassembly function.

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 rather than implementing a separate ship system

How to Use

1. Craft or obtain one of the control keys.

2. Hold the key in your hand.

3. Sneak while looking at an Eureka ship helm.

4. Right-click the helm.

5. The corresponding ship action will be executed on the server.

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

Crafting Recipes

Each key uses the following pattern:

S R S
R X R
S R S

Where:

• S = Stone

• R = Redstone Dust

• X = The 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: Commands Are Currently Not Working

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

Please 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.

The command issue may be addressed in a future update. However, because this is a personal experimental project and the author has limited development experience, a fix or future update cannot be guaranteed.

Item IDs

vr_eureka_disassembler:assembly_key
vr_eureka_disassembler:alignment_key
vr_eureka_disassembler:disassembly_key

The keys can be obtained with Minecraft’s standard /give command:

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

These standard Minecraft /give commands are separate from the currently broken /vrship commands.

Requirements

This mod 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 themselves to function.

Installation

Install the mod on both the client and the server.

1. Install Minecraft Forge for Minecraft 1.20.1.

2. Install Valkyrien Skies.

3. Install Eureka! Ships!

4. Create a complete backup of your world.

5. Place the Eureka Control Keys JAR in the mods folder.

6. 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.

Important Backup and Data-Loss Warning

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

Eureka and Valkyrien Skies modify blocks, entities, coordinates, and moving ship structures. A bug, crash, incompatibility, incorrect ship operation, interrupted server process, or unexpected interaction with another mod could potentially cause:

• World corruption

• Missing or duplicated blocks

• Damaged ship structures

• Lost items

• Lost player data

• Server crashes

• Chunks that fail to load correctly

• Other unexpected damage to Minecraft data

Use this mod entirely at your own risk.

To the extent permitted by applicable law, the author is not responsible for corrupted worlds, lost progress, damaged game data, lost items, server problems, hardware or software issues, or any other direct or indirect loss resulting from the installation or use of this mod.

A backup should be stored separately from the active Minecraft world or server folder. A copied save inside the same active directory may not protect against every type of failure.

Support Limitations

This mod was created as a personal solution to a specific Vivecraft and Eureka compatibility problem.

The author is not a professional Minecraft mod developer and has limited knowledge and experience with Forge, Eureka, Valkyrien Skies, Vivecraft, and large modpack compatibility.

Bug reports are welcome and may help improve the project, but please understand that:

• The author may not be able to identify the cause of a problem

• The author may not be able to reproduce problems from other environments

• Some crashes or compatibility issues may be beyond the author’s ability to fix

• Support for every modpack or configuration cannot be provided

• Updates and fixes are not guaranteed

• Response times are not guaranteed

I apologize for these limitations and for any inconvenience caused by bugs or compatibility problems.

When reporting an issue, please include:

• Minecraft version

• Forge version

• Eureka version

• Valkyrien Skies version

• Vivecraft version, when applicable

• Eureka Control Keys version

• Whether the issue occurred in single-player or multiplayer

• The relevant latest.log or crash report

• A description of what happened immediately before the issue

Providing this information does not guarantee that the issue can be fixed, but it may make investigation possible.

AI-Assisted Development Disclosure

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

AI was used to help write, review, debug, and revise parts of the Java source code and Forge project structure. The mod’s purpose, feature requirements, behavior, testing process, crash reports, and final implementation decisions were directed and evaluated by the project author.

The addon was improved through repeated real-world testing in a Forge, Vivecraft, Eureka, and Valkyrien Skies environment.

Because AI-generated or AI-assisted code can contain errors, incomplete assumptions, or unexpected behavior, users should treat this project as experimental and follow the backup instructions above.

AI assistance was used as a development tool and does not imply any affiliation with Mojang, Microsoft, Vivecraft, Valkyrien Skies, Eureka, CurseForge, or their respective developers.

Compatibility and Disclaimer

This is an unofficial and experimental addon.

It is not an official Vivecraft, Eureka, or Valkyrien Skies project and is not endorsed, reviewed, or supported by their developers.

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

Compatibility with every Minecraft version, Forge version, modpack, Eureka version, Valkyrien Skies version, Vivecraft version, server environment, or combination of other mods cannot be guaranteed.

By installing or using this addon, you acknowledge that you are using experimental software at your own risk and that you are responsible for maintaining appropriate backups of your worlds and other game data.