Skip to content

3D building environment for a popular video game "Rust". Create and customize structures, simulate raids, calculate building costs and import/export your designs with ease.

Notifications You must be signed in to change notification settings

krystiandzirba/Rust-Base-Builder

Repository files navigation

Rust Base Builder

GitHub repo size GitHub release (latest by date) GitHub GitHub last commit GitHub activity

Rust Base Builder - 3D building environment for a popular video game "Rust". Create and customize structures, simulate raids, calculate building costs and import/export your designs with ease.

www.rustbasebuilder.eu

or

App: https://krystiandzirba.github.io/Rust-Base-Builder/

RBB1

Table of Contents

1. Edit Mode
   1.1 Placing Models
   1.2 Rotating Models Before Placement
   1.3 Symmetrical Building
   1.4 Setting Building Height
   1.5 Move, Rotate, and Transform Models with Keyboard Input
   1.6 Move, Rotate, and Transform Models with Mouse Input
   1.7 Transform Distance Units
   1.8 Upgrade, Downgrade, or Delete Selected and All Models
   1.9 Pivot Controls
   1.10 Placing Prebuilt Bases
   1.11 Build + Upkeep Cost
   1.12 Models Visibility Settings
2. Local Storage
3. Import | Export Base
   3.1 Export + Import via .txt File
   3.2 Export + Import via Generated Code
4. Raid Mode
5. Future Updates

1. Edit Mode

1.1 Placing Models

Build your base from scratch, or modify and view an existing one.
To get started, select any object from the list on the left and place it on the grid.

1.2 Rotating Models Before Placement

Before placing an object, you can rotate it using the "Q" and "E" keys.
Use the rotation wheel at the bottom (15° | 30° | 60° | 90°) to adjust the angle of rotation.

1.3 Symmetrical Building

Enable the symmetry to automatically place mirrored objects along the X, Z, or X+Z axes.

1.4 Setting Building Height

Adjust the height at which you want to place the model. (1 = full model height).

1.5 Move, Rotate, and Transform Models with Keyboard Input

- Use the WASD keys to move the selected object along the X, Y, or Z axis.
- Move objects up and down using the "SPACE" and "CTRL" keys.
- Rotate the object with the "Q" and "E" keys.
- To delete a selected object, press "BACKSPACE ←" or "DEL".

1.6 Move, Rotate, and Transform Models with Mouse Input

You can also manipulate models using mouse controls with the buttons located at the bottom of the screen.

1.7 Transform Distance Units

Adjust the multiplier value for model transformations.
Choose from preset values like 0.125, 1 (default), or 5.
Or set a custom value between 0 and 50.

1.8 Upgrade, Downgrade, or Delete Selected and All Models

When an object is selected, a small menu will appear with three options: upgrade to a higher tier, downgrade to a lower tier, or delete.
You can also enable the model eraser to remove any model with a single click or delete all models at once.

1.9 Pivot Controls

For more dynamic model manipulation, enable the pivot controls to drag models across the canvas along specific axes.

1.10 Placing Prebuilt Bases

Select and place a prebuilt base from popular YouTube tutorials.
Prebuilt base types:

  • Tutorial: 1:1 ratio of stone, metal, and armored materials as seen in the tutorial.
  • Stone: Base built entirely using stone models.
  • Metal: Base built entirely using metal models.
  • Armored: Base built entirely using armored models.

1.11 Build + Upkeep Cost

All the build cost will be displayed on the right side along with the upkeep cost (scaling tiers):
tier 1: 10% for the first 15 objects
tier 2: 15% for next 75 objects
tier 3: 20% for another 75 objects
tier 4: 33% for any object above 175th
You can also enable the miscs (workbenches, storages, furnaces) to be counted in the build cost (with upkeep ommited)

Image

1.12 Models Visibility Settings

To get a clearer view of your base, you can toggle various modes or enable X-ray mode to render the entire base as a wireframe.
The number next to the "x-ray" button shows the total count of all current models,
while the number beside each specific model type indicates the count of models for that particular type.

2. Local Storage

Any base or layout you create can be saved to your browser's local storage. If you reload the page or return later, your saved base will load automatically.
You can also delete the saved base from local storage at any time.

3. Import | Export Base

If you'd like to share your base with a friend or move it to another device, there are two simple ways to do so.

3.1 Export + Import via .txt File

You can export and import your base using a .txt file, which contains all the data, including models, their positions, and rotations.

To Export and Import via the .txt file:

  • Select the "Export" → "via .txt file".
  • You can name your file or leave it with default name.
  • press the "download the base .txt file".

Another device | browser

  • Select the "Import" → "via .txt file".

  • Press the "+ Import base file".

  • Enable the model placing, "place the base (off → on)".

  • Start placing the base on the canvas.

  • Disable the model placing, "place the base (on → off)".

3.2 Export + Import via Generated Code

If you prefer not to download a file, you can generate a code and use it in the import field.

To Export and Import via the generated code:

  • Select the "Export" → "via code".
  • Press the "generate the base code" button.
  • copy the generated code to the clipboard.

Another device | browser

  • Select the "Import" → "via code".

  • Paste the generated code to the "enter / pase the base code" input field.

  • Press the "apply" button.

  • Enable the model placing, "place the base (off → on)".

  • Start placing the base on the canvas.

  • Disable the model placing, "place the base (on → off)".

4. Raid Mode

Simulate an raid attack on your own base to test its weaknesses.
First, choose the weapon | tool you want to use for the raid:

  • "most efficient" automatically calculate the most efficient way to destroy the selected structure.
  • rockets
  • C4s
  • EXP. 5.56 ammo
  • satchel charges

Once you've selected the type, you can start destroying the objects with mouse click.
If you want to start the raid again, or reset it, use the "reset raid" button.

Image

All raid costs will be displayed on the right side, categorized by weapon type and required resources.
You can also enable the sub-ingredients and gunpowder calculator.

Image

5. Future updates:

- Mobile Support
- Add remaining important models and structures (external walls / fences / shelves / campfire / beds / research table / large furnace ... )
- First person mode (depends on performance impact)
- Pixel gap structures building
- Rust-like object snapping (depends on performance impact)
- Faster building
- Object copy + paste
- Undo button
- Different switchable layouts
- Performance Improvements
- UI | UX tweaking
- Custom rotation angles
- Dynamic performance for low-end systems
- Updated sounds

Please note that this app is GPU and Memory heavy, if you experience any performance issues, try using the Performance Mode available in the settings.

About

3D building environment for a popular video game "Rust". Create and customize structures, simulate raids, calculate building costs and import/export your designs with ease.

Topics

Resources

Stars

Watchers

Forks

Languages