FBX Spawner GUI for ULTRAKILL

Version: 1.0.1
Author: Jaba
Game: ULTRAKILL
Tags: GUI, Spawner, FBX

Description

FBX Spawner GUI adds a simple in-game GUI to ULTRAKILL for spawning 3D .fbx objects.
You can quickly test models using built-in buttons.

Features:

• Scrollable GUI listing all .fbx models.
• Automatic scanning of the Models folder next to the DLL.
• Placeholder cubes for quick positioning checks.
• Fully integrated with BepInEx.

Installation

1. Make sure BepInEx is installed in your game folder.
2. Copy epic3dloader.dll into:

BepInEx/plugins/epic3dloader/

markdown Copy code

1. Create a Models folder next to the DLL and place your .fbx files there:

BepInEx/plugins/epic3dloader/Models/

yaml Copy code

1. Launch the game and press F1 to open the menu.
   Press ESC to close it.

On first launch, the Models folder will be created automatically if it doesn't exist.

Controls

• F1 — toggle menu
• ESC — close menu
• Model buttons — spawn the corresponding object in the game world

Compatibility

• Requires BepInEx 5.4.23.4+
• ULTRAKILL (tested on recent versions)

Additional Requirements

The mod uses Assimp for .fbx importing. Make sure the following files are present next to the DLL:

• assimp64.dll — for 64-bit
• assimp32.dll — for 32-bit

They are required for model loading. Without them, the GUI will work, but spawning models will fail.

License

MIT License — free to use and modify. See LICENSE for details.

Notes

• The mod interacts directly with the ULTRAKILL engine, creating objects and modifying the scene.
• Heavy .fbx files may cause bugs or instability.
• Only basic placeholder .fbx models are fully supported.
  NOTE_FOR_FORKERS.md

markdown Copy code

Attention Forkers

This mod is not just a GUI. It directly interacts with the ULTRAKILL engine, creating objects in the scene and altering spawn logic.

Features and risks:

• Uses low-level Unity calls via BepInEx.
• Spawning large .fbx models may be unstable.
• Code does not guarantee saved progress and may conflict with other mods.
• Even small changes can break the menu or spawning system.

Recommendations for forkers:

• Test changes only on a copy of the project.
• Use placeholder models before adding real .fbx files.
• Submit bug reports with BepInEx logs to ensure reproducibility.

Assimp Libraries

FBX importing relies on Assimp binaries (assimp64.dll and assimp32.dll).

• Keep them in the same folder as the DLL.
• Do not remove or rename them.
• Modifying them may break model loading completely.