Skip to content

Commit

Permalink
Merge pull request #22 from WILLATRONIX/master
Browse files Browse the repository at this point in the history
everything up to 3.0.0 (almost)
  • Loading branch information
Moulberry committed Jun 3, 2024
2 parents 00242f0 + 4975254 commit b750f0d
Show file tree
Hide file tree
Showing 62 changed files with 692 additions and 211 deletions.
30 changes: 19 additions & 11 deletions src/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,9 @@
- [Extrude](builder/extrude.md)
- [Erase](builder/erase.md)
- [Setup Symmetry](builder/setupsymmetry.md)
- [Display Entities](builder/displayentities.md)
- [Marker Entities](builder/marker.md)
- [Edit Block Attributes](builder/blockattributes.md)
- [Capabilities](capabilities/intro.md)
- [Tinker](capabilities/tinker.md)
- [No Updates](capabilities/noupdates.md)
Expand All @@ -19,27 +22,30 @@
- [Bulldozer](capabilities/bulldozer.md)
- [Editor Mode](editor/intro.md)
- [Main Menu Bar](editor/mainmenubar.md)
- [Clipboard and Placements](editor/clipboardandplacements.md)
- [Selections](editor/selections.md)
- [Gizmos](editor/gizmos.md)
- [Blueprints](editor/blueprints.md)
- [Views](editor/views.md)
- [Tool Masks](editor/toolmasks.md)
- [Active Block](editor/activeblock.md)
- [Target Info](editor/targetinfo.md)
- [History](editor/history.md)
- [World Properties](editor/worldproperties.md)
- [Tool Presets](editor/toolpresets.md)
- [Windows](editor/windows/intro.md)
- [Clipboard](editor/clipboard.md)
- [Views](editor/windows/views.md)
- [Blueprints](editor/windows/blueprints.md)
- [Active Block](editor/windows/activeblock.md)
- [History](editor/windows/history.md)
- [Tool Masks](editor/windows/toolmasks.md)
- [Target Info](editor/windows/targetinfo.md)
- [World Properties](editor/windows/worldproperties.md)
- [Palette](editor/windows/palette.md)
- [Tool Options](editor/windows/tooloptions.md)
- [Tools](tools/intro.md)
- [Selection Tools](tools/selection/intro.md)
- [Lasso Select](tools/selection/lasso.md)
- [Box Select](tools/selection/boxselect.md)
- [Magic Select](tools/selection/magicselect.md)
- [Freehand Select](tools/selection/freehandselect.md)
- [Painting Tools](tools/painting/intro.md)
- [Painter](tools/painting/painter.md)
- [Noise Painter](tools/painting/noisepainter.md)
- [Biome Painter](tools/painting/biomepainter.md)
- [Clentaminator](tools/painting/clentaminator.md)
- [Gradient Painter](tools/painting/gradientpainter.md)
- [Script Brush](tools/painting/scriptbrush.md)
- [Drawing Tools](tools/drawing/intro.md)
Expand All @@ -48,6 +54,7 @@
- [Rock](tools/drawing/rock.md)
- [Weld](tools/drawing/weld.md)
- [Melt](tools/drawing/melt.md)
- [Stamp](tools/drawing/stamp.md)
- [Text](tools/drawing/text.md)
- [Shape](tools/drawing/shape.md)
- [Heightmap Tools](tools/heightmap/intro.md)
Expand All @@ -60,8 +67,9 @@
- [Shatter](tools/manipulation/shatter.md)
- [Extrude](tools/manipulation/extrude.md)
- [Modify](tools/manipulation/modify.md)
- [Ruler Tool](tools/ruler.md)
- [Path Tool](tools/path.md)
- [Other](tools/other/intro.md)
- [Ruler Tool](tools/other/ruler.md)
- [Path Tool](tools/other/path.md)
- [Advanced](advanced/intro.md)
- [Commands](advanced/commands.md)
- [Config](advanced/configuration.md)
24 changes: 22 additions & 2 deletions src/advanced/commands.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Commands are essential for management and debugging.

### /axiomenablecheats

- Forces the world to have cheats enabled, even if they are disabled.
- Forces the world to have cheats enabled, even if they are disabled. This is not available in Multiplayer.

### /axiomhandshake

Expand All @@ -26,6 +26,26 @@ Commands are essential for management and debugging.

- Returns Axiom's status and information on how to resolve issues.

## Axiom Gamerule Commands

These are some extra commands for controlling the world and its properties. These are not available when playing on a paper server.

### axiomDoBlockDrops

- Unlike the [doTileDrops](https://minecraft.wiki/w/Game_rule) gamerule, Axiom's gamerule covers all blocks.

### axiomDoBlockGravity

- When False, all gravity affected blocks like sand will never update regardless of the interaction.

### axiomDoTrampleFarmland

- When False, farmland cannot be trampled by any entity.

### axiomPlayerInvulnerability

- Prevents all forms of death, including void damage and /kill.

## Compatible commands

`//pos1` and `//pos2` are part of Axiom, but are intended to be used alongside WorldEdit.
`//pos1` and `//pos2` are part of Axiom, but are intended to be used alongside WorldEdit. They expand the provided corner point to the player's position.
36 changes: 19 additions & 17 deletions src/advanced/configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,40 +2,42 @@

Axiom has its own dedicated configuration located in `.minecraft/config/axiom` containing 3 folders and 3 files.

The folders are used to store saved [Blueprints](editor/blueprints.md), [Heightmaps](editor/tools/heightmap/elevation.md) and [Tool Presets](editor/toolpresets.md) so even if the mod is removed, your assets are saved.
The folders are used to store saved [Blueprints](/editor/windows/blueprints.md), [Heightmaps](/editor/tools/heightmap/elevation.md) and [Tool Presets](/editor/toolpresets.md) so even if the mod is removed, your assets are saved.

The files contain the more important information such as UI layout and enabled capabilities. Axiom uses a variant of JSON called HOCON (Human-Optimized Config Object Notation).

Below are the three files alongside their descriptions.

### `.axiominternal.hocon`

| Key | Description |
| ------------------------------ | --------------------------------------------------------------------- |
| completedTutorials | Lists the tools that have shown their short tutorial. |
| customDowngradeSuggestions | Lists the downgrades suggested by Axiom. |
| globalScale | A float representing the [Editor](editor/intro.md) UI Scale. |
| lastTranslationCount | A value determining the amount of translations. |
| openEditorWindowTypes | A list of open windows in the editor. |
| rootEditorPalette | The default block palette for the editor mode. |
| savedCustomTheme | Stores the currently active theme as a string. |
| showCloseWindowButton | A boolean to toggle the "x" to close windows. |
| showNon90DegreeRotationWarning | A boolean to toggle the warning before applying non-90-degree angles. |
| showToolMaskOpenWarning | A boolean to toggle the warning when using tool masks. |
| shownIntroduction | A boolean representing whether the introduction has been completed. |
| Key | Description |
| ------------------------------ | -------------------------------------------------------------------------------------- |
| completedTutorials | Lists the tools that have shown their short tutorial. |
| customDowngradeSuggestions | Lists the downgrades suggested by Axiom. |
| globalScale | A float representing the [Editor](editor/intro.md) UI Scale. |
| lastTranslationCount | A value determining the amount of translations. |
| openEditorWindowTypes | A list of open windows in the editor. |
| rootEditorPalette | The default block palette for the editor mode. |
| savedCustomTheme | Stores the currently active [Theme](/editor/windows/intro.md#Themes) as a string. |
| showCloseWindowButton | A boolean to toggle the "x" to close windows. |
| showNon90DegreeRotationWarning | A boolean to toggle the warning before applying non-90-degree angles. |
| showToolMaskOpenWarning | A boolean to toggle the warning when using [Tool Masks](/editor/windows/toolmasks.md). |
| shownIntroduction | A boolean representing whether the introduction has been completed. |

### `.axiom.hocon`

| Key | Description |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| blockAttributes | Contains the currently toggled block attributes. |
| blockAttributes | Contains the currently toggled [Block Attributes](/builder/blockattributes.md). |
| blueprint | Stores the toggle to automatically refresh and a list of all used blueprint tags. |
| capabilities | Lists all abilities and their state. Also contains the `autoSwapToCreative` boolean that controls switching to creative when opening the [context menu](builder/contextmenu.md). |
| capabilities | Lists all abilities and their state. Also contains the `autoSwapToCreative` boolean that controls switching to creative when opening the [context menu](/builder/contextmenu.md). |
| keybinds | Stores in-game keybinds and settings for the Builder Mode and camera movement. |
| toolKeybinds | Stores all Editor keybinds for switching tools. |
| rendering | Stores booleans representing the toggles in the Toolbox found in the [Context Menu](builder/contextmenu.md). |
| rendering | Stores booleans representing the toggles in the Toolbox found in the [Context Menu](/builder/contextmenu.md). |


### `imgui.ini`

This file stores [windows](/editor/windows/intro.md) and their positions.

This file is generally not meant to be modified, hence why it uses a different file format. However, if you're having an issue with a specific window that you can't recover, you can either edit or delete this file to fix the issue.
18 changes: 18 additions & 0 deletions src/builder/blockattributes.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
# Edit Block Attributes

The Edit Block Attributes menu can be used to configure multiple settings that alter gameplay.

| Setting | Description |
| ---------------------------- | ------------------------------------------------------------------------------------------ |
| Show Collision Mesh | Creates a red outline for every block with a transparent hitbox like barriers or fences. |
| Show Light Blocks | Adds a texture[^note1] for light blocks and enables interactions with them. |
| Show Structure Void Blocks | Adds a texture[^note2] for structure void blocks. |
| Expand Hitboxes to Full Cube | Sets all hitboxes to a full block. Affects blocks like slabs or buttons. |
| Make Fluid Hitboxes Solid | Allows you to break individual blocks of water with your fist. |
| Prevent Interactions | Stops the player from opening containers or interacting with blocks while holding a block. |

## Notes

[^note1]: ![Light Block Texture](/img/light_block_15.png)

[^note2]: ![Structure Void Texture](/img/structure_void.png)
32 changes: 29 additions & 3 deletions src/builder/clone.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,31 @@
# Clone
# ![](/img/buildertools/clone.png) Clone

Clone is similar to [Move](move.md), but it copies the blocks instead of moving them.
The clone tool allows you to copy a cuboid area and paste it elsewhere multiple times.

The process for using Clone is the same as the Move tool, so refer to [Move](move.md) for more detailed information
## Creating Selections

To create a selection, start by using left-click to select your first corner and then right-click to select the second. You can use middle-click to select faces instead of the corners. This makes it much easier to select blocks that don't already have edges.

## Moving Selections

Once you're happy with your selection, you can move it by scrolling with the mouse wheel. Now, a hologram will represent the selection you'll be working with. You will also be presented with different controls, using middle-click you can move the selection to the direction you're facing.

Using the scroll wheel, you can nudge the selection by one block. Scrolling up will push the selection away from the player and scrolling down will bring the selection closer to the player, so the direction the player is facing determines the direction the selection is pulled or pushed. The arrows on the faces of your selection will indicate the scroll up direction.

By holding the 'X', 'Y' or 'Z' keys, you can force the selection to move in a single axis. For example, holding the 'X' key while nudging the selection will force it to move on the X axis only.

## Modifying Selections

You can further modify a selection by two ways: flip and rotate. These can alter the orentation of the selection in almost any way.

To flip a selection, use `Ctrl + F`. This will flip the selection depending on the direction you're facing. The arrow on the side of your selection will indicate the direction your selection will be flipped.

To rotate a selection, use `Ctrl + R`. This will rotate the selection clockwise on the X and Z axis. For example, a selection facing north will be face east after rotating it.

With a selection, you're still able to expand the selection with middle-click. Using left or right-click also works to set a corner again.

## Confirming Selections

After you're happy with your movement and modifications, use right-click to confirm the selection, then use left-click to finish the selection. If you want to create multiple copies, move the selection using your scroll wheel instead of finishing the selection.

If you're not happy with the result, use `Ctrl + Z` to undo the placement. If you can't make up your mind, you can use `Ctrl + Y` to redo your undo.
Loading

0 comments on commit b750f0d

Please sign in to comment.