Difference between revisions of "Aerosniper"

From ThetaWiki
Jump to: navigation, search
m (Performers)
 
(9 intermediate revisions by the same user not shown)
Line 8: Line 8:
 
}}
 
}}
  
'''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  
+
'''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 three '''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.
 +
** '''List''' - Snipe a random voxel type from your voxel list for each individual block within your snipe.
 +
 
 +
* 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''' | '''l'''>[ '''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 ==
 
== Commands ==
 +
=== The Aerosniper Command ===
 
* Base command: '''/as''' - Displays current brush settings.
 
* Base command: '''/as''' - Displays current brush settings.
 
** '''brusheslong''' - List primary names for brushes.
 
** '''brusheslong''' - List primary names for brushes.
 
** '''brushes''' - List alternate names for brushes (typically abbreviated).
 
** '''brushes''' - List alternate names for brushes (typically abbreviated).
** '''toolvoxel''' - Toggle selecting voxel types using the '''shift + left-click''' modifier.
+
** '''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.
 
** '''toggle''' or '''enable''' or '''disable''' - Activate or deactivate all sniping tool functionality for yourself only.
 
** '''liquid''' - Toggle ray tracing through liquid.
 
** '''liquid''' - Toggle ray tracing through liquid.
Line 21: Line 60:
  
  
 +
=== The Brush Command ===
 
* Base command: '''/b''' (alias: '''/brush''') - Display current brush settings.
 
* Base command: '''/b''' (alias: '''/brush''') - Display current brush settings.
 
** '''[brush]''' - Set your brush.
 
** '''[brush]''' - Set your brush.
Line 27: Line 67:
  
  
 +
=== The Brush Tool Command ===
 
* Base command: '''/btool'''
 
* Base command: '''/btool'''
 
** '''assign'''
 
** '''assign'''
Line 35: Line 76:
  
  
 +
=== The Brush Reset (Default) Command ===
 
* Base command: '''/d''' (alias: '''/default''') - Reset your current brush settings.
 
* Base command: '''/d''' (alias: '''/default''') - Reset your current brush settings.
  
  
 +
=== The Performer Command ===
 
* Base command: '''/p''' (alias: '''/performer''')
 
* 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'''.
+
** '''< 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.
 
* Base command: '''/u''' (alias: '''/undo''') - Undo your most recent action.
 
** '''[integer]''' - Undo a quantity of recent actions.
 
** '''[integer]''' - Undo a quantity of recent actions.
  
  
 +
=== The Undo User Command ===
 
* Base command: '''/uu''' (alias: '''/undouser''')
 
* Base command: '''/uu''' (alias: '''/undouser''')
 
** '''<sniper>''' - Undo the most recent action of a specific online user.
 
** '''<sniper>''' - Undo the most recent action of a specific online user.
Line 52: Line 97:
  
  
 +
=== 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).
 
* 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.
 
** '''[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).
 
* 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.
 
** '''[block data]''' - Set your voxel replacement to the typed material with optional block data.
  
  
* Base command: '''/vc''' (alias: '''/voxelcenter''').
+
=== The Voxel Center Command ===
 +
* Base command: '''/vc''' (alias: '''/voxelcenter''')
 
** '''<integer>''' - Set your voxel center to an integer value.
 
** '''<integer>''' - Set your voxel center to an integer value.
  
  
* Base command: '''/vd''' (alias: '''/voxeldepth''').
+
=== The Voxel Depth Command ===
 +
* Base command: '''/vd''' (alias: '''/voxeldepth''')
 
** '''<integer>''' - Set your voxel depth to an integer value.
 
** '''<integer>''' - Set your voxel depth to an integer value.
  
  
* Base command: '''/vh''' (alias: '''/voxelheight''').
+
=== The Voxel Height Command ===
 +
* Base command: '''/vh''' (alias: '''/voxelheight''')
 
** '''<integer>''' - Set your voxel height to an integer value.
 
** '''<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.
 
* 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.
 
** '''[material]''' - Add or remove the typed material to/from your voxel list.
  
 
== Brushes ==
 
== Brushes ==
It's a-comin'.
+
=== The Stencil Brush ===
 +
Tag: '''st''' | Alias: '''stencil'''
 +
 
 +
''The copy/paste/rotate/flip everything brush.''
 +
 
 +
* '''Arrow''': Snipe stencil into existence.
 +
* '''Gunpowder''': Select primary point, secondary point, and paste point.
 +
 
 +
The stencil brush is the best way to save your builds so you may paste them elsewhere in the future. This brush, as with all brushes that modify blocks, takes advantage of Aerosniper's accurate and high-speed block editing protocol and undo system. This makes it ideal for builds, props, and foliage of all sizes. You can select a stencil by simply appending an existing stencil's name as a parameter: '''/b st <stencilname>'''. If you would like to create your own stencil, you must first select three points with the gunpowder tool. The first two points are opposite corners of a cuboid and the third point is the paste point--when you snipe the stencil into existence, it will be oriented with the paste point at your cursor. After that, submit the same command with an unused stencil name. Optionally, you can append a password which will serve to protect your stencil from modification by users without the password. For example, '''/b st mystencil p:shaft''' will save a stencil with the name "mystencil" and password "shaft" insofar as three points have been selected.
 +
 
 +
Optionally, you may set a comment to be associated with your stencil by first submitting the command '''/b st c:<comment>''' before saving your stencil. Comments may utilize formatting and color codes.
 +
 
 +
After selecting a stencil, you may wish to rotate it by a specific quadrant rotation (0, 90, 180, or 270 degrees) or you may wish to rotate the stencil randomly. To do this, submit the command '''/b st r:<integer>''' or '''/b st r:rand'''. Similarly, you may flip your stencil along the X or Z axes via '''/b st f:x''', '''f:z''', and '''f:rand'''; '''f:none''' clears the selection. Stencils rotate and flip perfectly, ensuring your stairs, fences, signs, player heads, etc. are all facing in the proper relative direction.
 +
 
 +
=== The Stencil List Brush ===
 +
Tag: '''sl''' | Alias: '''stencillist'''
 +
 
 +
* '''Arrow''': Snipe a random stencil from the list into existence with a random orientation.
 +
* '''Gunpowder''': Snipe a random stencil from the list into existence with a specific orientation.
 +
 
 +
The Stencil List brush empowers your stencils, enabling you to build lists of stencils which are selected randomly upon sniping. To do so, submit the '''/b sl x:<stencil>''' command to add or remove stencils from your current list. To save your list, submit the '''/b sl s:<name>''' command. Like stencils, stencil lists may be decorated with a comment and/or secured with a password. Rotation values, flip axes, and paste options are also set in the same way.

Latest revision as of 19:44, 5 March 2019

Aerosniper
[[File:|300px|alt=Aerosniper]]
Basic information
Lead developer: Aerocet


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 three 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.
    • List - Snipe a random voxel type from your voxel list for each individual block within your snipe.
  • 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 | l>[ 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

The Stencil Brush

Tag: st | Alias: stencil

The copy/paste/rotate/flip everything brush.

  • Arrow: Snipe stencil into existence.
  • Gunpowder: Select primary point, secondary point, and paste point.

The stencil brush is the best way to save your builds so you may paste them elsewhere in the future. This brush, as with all brushes that modify blocks, takes advantage of Aerosniper's accurate and high-speed block editing protocol and undo system. This makes it ideal for builds, props, and foliage of all sizes. You can select a stencil by simply appending an existing stencil's name as a parameter: /b st <stencilname>. If you would like to create your own stencil, you must first select three points with the gunpowder tool. The first two points are opposite corners of a cuboid and the third point is the paste point--when you snipe the stencil into existence, it will be oriented with the paste point at your cursor. After that, submit the same command with an unused stencil name. Optionally, you can append a password which will serve to protect your stencil from modification by users without the password. For example, /b st mystencil p:shaft will save a stencil with the name "mystencil" and password "shaft" insofar as three points have been selected.

Optionally, you may set a comment to be associated with your stencil by first submitting the command /b st c:<comment> before saving your stencil. Comments may utilize formatting and color codes.

After selecting a stencil, you may wish to rotate it by a specific quadrant rotation (0, 90, 180, or 270 degrees) or you may wish to rotate the stencil randomly. To do this, submit the command /b st r:<integer> or /b st r:rand. Similarly, you may flip your stencil along the X or Z axes via /b st f:x, f:z, and f:rand; f:none clears the selection. Stencils rotate and flip perfectly, ensuring your stairs, fences, signs, player heads, etc. are all facing in the proper relative direction.

The Stencil List Brush

Tag: sl | Alias: stencillist

  • Arrow: Snipe a random stencil from the list into existence with a random orientation.
  • Gunpowder: Snipe a random stencil from the list into existence with a specific orientation.

The Stencil List brush empowers your stencils, enabling you to build lists of stencils which are selected randomly upon sniping. To do so, submit the /b sl x:<stencil> command to add or remove stencils from your current list. To save your list, submit the /b sl s:<name> command. Like stencils, stencil lists may be decorated with a comment and/or secured with a password. Rotation values, flip axes, and paste options are also set in the same way.