Difference between revisions of "Aerosniper"

Revision as of 06:32, 25 February 2019

Aerosniper is a powerful long-range terrain editing tool. It is inspired by VoxelSniper and re-imagined for modern versions of Minecraft. More specifically, Aerosniper provides all the tooling you're familiar with, but leverages the current block data system that replaced block IDs and data values. Aerosniper is extremely fast (faster than FAWE!) and is the perfect creative arsenal for a busy environment. Aerosniper is currently available exclusively on ThetaBlocks. This documentation will grow as the plugin evolves.

Lighting

Hey, what's up with this weird lighting?

Aerosniper for Minecraft version 1.13 utilizes a delayed lighting system which efficiently corrects lighting in a delayed fashion after snipes have been made. In 1.14, this will be changed to take advantage of the new asynchronous lighting system. In other words, it's working as intended! Expect to see improvements once 1.14 arrives, however.

Performers

There are two main classifications of brushes: standard brushes and performer brushes. Standard brushes typically modify the world in a dynamic fashion, adding or removing blocks directly dependent upon the context of your snipe target (or the area around it). Performer brushes, on the other hand, utilize block data that you set or capture using the corresponding voxel and voxel replacement commands explained below. For example, the Ball Brush is a performer brush because it will produce a sphere composed entirely of your voxel type.

As an exercise, you can submit the /b ball command and right-click with the arrow to produce a sphere at the target location (or at the maximum extent of your brush range, which will be explained further along in the documentation). If you haven't changed your voxel type already, you will produce a ball of air. To change this, try submitting the /v stone command to change your voxel type.

There are two primary performers and four secondary (or replacement) performers.

• Primary Performers:
  • Material - Snipe your voxel type with default block data settings.
  • State - Snipe your voxel type with specified block data settings.

• Secondary Performers
  • Material - Replace blocks which match your voxel replacement type.
  • State - Replace blocks which match your voxel replacement type and its corresponding block data settings.
  • Include - Replace blocks which match the list of voxel replacement types contained within your voxel list.
  • Exclude - Replace blocks which do not match the list of voxel replacement types contained within your voxel list.

To set your performer, first select a performer brush and append the appropriate parameter as outlined: < m | s >[ m | s | n | x ] If you are changing your performer, the primary performer is mandatory. The secondary performer is optional.

As a more advanced exercise, submit the following commands:

• /b ball mn
• /v terracotta
• /vl grass_block
• /vl dirt
• /vl stone

This combination of settings will create a ball brush which replaces only grass blocks, dirt, and stone with terracotta in a snipe location that resembles a sphere. To replace the same block types in a cube-shaped snipe, you would simply need to change your brush using /b voxel mn.

Commands

The Aerosniper Command

• Base command: /as - Displays current brush settings.
  • brusheslong - List primary names for brushes.
  • brushes - List alternate names for brushes (typically abbreviated).
  • toolvoxel - Toggle selecting voxel types using the shift + left-click or shift + right-click modifiers.
  • toggle or enable or disable - Activate or deactivate all sniping tool functionality for yourself only.
  • liquid - Toggle ray tracing through liquid.
  • range - Toggle ranged sniping mode.
    • [integer] - Change the numeric value of your sniping range.

The Brush Command

• Base command: /b (alias: /brush) - Display current brush settings.
  • [brush] - Set your brush.
    • [parameters] - Set brush-specific settings or your performer type.
  • [double] - Set your brush size.

The Brush Tool Command

• Base command: /btool
  • assign
    • arrow or powder
      • <toolid> - Assign the item in your hand to perform either arrow or gunpowder brush functionality for your currently selected brush.
  • remove - Remove the assigned brush from the tool in your hand.
    • [toolid] - Remove the assigned brush from the tool identified by the name of your choice.

The Brush Reset (Default) Command

• Base command: /d (alias: /default) - Reset your current brush settings.

The Performer Command

• Base command: /p (alias: /performer)
  • < m | s >[ m | s | n | x ] - If you have a performer brush selected, set your primary performer to material or state and optionally set your replacement performer to material, state, include list, or exclude list. Note: All snipes are completed without triggering physics updates except in rare cases wherein a material must be sniped with physics to avoid unintended side effects. Physics sniping cannot be toggled.

The Undo Command

• Base command: /u (alias: /undo) - Undo your most recent action.
  • [integer] - Undo a quantity of recent actions.

The Undo User Command

• Base command: /uu (alias: /undouser)
  • <sniper> - Undo the most recent action of a specific online user.
    • [integer] - Undo a quantity of recent actions for a specific online user.
      • force - Undo a quantity of recent actions for a specific online or offline user.

The Voxel Command

• Base command: /v (alias: /voxel) - Set your voxel to the Block Data of your target block (or air if one cannot be found).
  • [block data] - Set your voxel to the typed material with optional block data.

The Voxel Replacement Command

• Base command: /vr (alias: /voxelreplace) - Set your voxel replacement to the Block Data of your target block (or air if one cannot be found).
  • [block data] - Set your voxel replacement to the typed material with optional block data.

The Voxel Center Command

• Base command: /vc (alias: /voxelcenter).
  • <integer> - Set your voxel center to an integer value.

The Voxel Depth Command

• Base command: /vd (alias: /voxeldepth).
  • <integer> - Set your voxel depth to an integer value.

The Voxel Height Command

• Base command: /vh (alias: /voxelheight).
  • <integer> - Set your voxel height to an integer value.

The Voxel List Command

• Base command: /vl (alias: /voxellist) - Add or remove the material type of your target block (or air if one cannot be found) to/from your voxel list.
  • [material] - Add or remove the typed material to/from your voxel list.

Brushes

It's a-comin'.