In-Depth Usage Guide
How to Use LiveBlocks to Its Full Potential
Make your server come alive with just a 10-15 minutes of work
Intro
So you've downloaded LiveBlocks and have it installed on your server. That's great! But what exactly are you supposed to do now...? Unfortunately, this is not one of those plugins that requires zero effort on the server administrator's end. In order to make the most out of this plugin, you're going to need to soak up a fair bit of information and become familiar with the many ins and outs of what it's capable of.
With that being said, let's get started.
Things You Should Know
LiveBlocks is a very flexible plugin. However, it is not a miracle worker. Let's cover what absolutely CAN NOT or SHOULD NOT be done with this plugin:
- YOU SHOULD NOT Change chunks of block data every half-second - Your server will suffer, women and children will cry, and the gods shall smite you where you stand
- THIS PLUGIN CANNOT Physically move the location of blocks. It simply changes blocks within a predefined 'cube' of space. The only way it can accomplish this is by setting the animation to give the illusion of an object moving. (This is not MoveCraft)
- YOU SHOULD NOT Skim this guide and then post that the plugin isn't working when it is (in fact) you not understanding how to properly control your LiveBlock regions
Additionally, there are a few terms you may not be familiar with that I will be referencing throughout this guide:
| Term | Meaning | |
|---|---|---|
| 1 | cuboid/voxel/region | Simply a 3D selection of blocks, defined by two points (the lower-left and upper-right corners that you set) |
| 2 | frame | A 'piece' of a full animation. If you have a wall that displays the words "Welcome" "To" "FancyTown" with each word displaying separately, then your animation has (effectively) 3 frames, each word belonging to its own frame. |
| 3 | temporary region | This refers to the 'pseudo-region' that you create whenever you select 2 points with the selection-tool (default: wooden hoe). Whenever a temporary region is used, it pulls your most recent 'top corner' and 'bottom corner' and creates a region object out of them. |
| 4 | focus | This refers to the current region that you're modifying. Any command referencing a focus will generally not require a region-name and simply use that value from memory. Your focus is automatically set when you create a new region (to that region). |
Creating Your First Region
As one might have assumed, you can't do much with this plugin unless you actually know how to create a LiveBlocks region! Below is a simple set of instructions to create one.
- Make sure you have LiveBlocks' "selector-tool" (defined in the config, defaults to wooden hoe) in your inventory. This tool is key for defining your temporary regions that are used by all region-creation commands
- Before you do anything, make sure to type /livb toggle - This enables your selection-tool!
- Start by figuring out where you want your region to be. When you think you have it figured out, use your selector tool to define the upper-right-corner and lower-left-corner of your region (remember, it needs to become a voxel). This can be done with the 'left click' and 'right click' respectively
- However the blocks are set-up currently, is how they're going to be set-up in the 'Base Frame' (0) of your LiveBlocks region. Make sure you build the object inside your region based on this
- When you think you've got what you're looking for, type /livb create <yourRegionName>
- The temporary region you originally defined will convert into a LiveBlock region with the specified name, and be added to the data set of all the regions. (This allows it to be saved and modified)
Congratulations! You just created your first LiveBlocks region. However, this isn't very useful or exciting until you start customizing the frames. See the next section for details.
Animating Your Region: The Basics
CONTINUING TO BE UPDATED
Comments