How to use DynamicStands

Jul 5, 2017
How to use DynamicStands
  • Servers

    Here is a list of servers, which are using this plugin(write me to join the list):

    - Sturmchicken.de


    Commands
    /ds edit - It gives you a pickaxe and the selection-book.
    Permission: armorstands.cmd.edit

    /ds create - Creates a new armor stand at your location.
    Permission: armorstands.cmd.create

    /ds load - Load a scene.
    Permission: armorstands.cmd.load

    /ds save <name> - Save all selected and added armor stands
    Permission: armorstands.cmd.save

    /ds add - Adds a single armor stand or a selection of multiple armor stands
    Permission: armorstands.cmd.add

    /ds clear - Clears your currently loaded or selected scene.
    Permission: armorstands.cmd.clear

    /ds combine - Bind a model to a spawner egg
    Permission: armorstands.cmd.add

    /ds copy - Copy and paste an specific armor stand to a specific place
    Permission: armor stands.cmd.copy

    /ds give - Gives you or an other player a permanent object
    Permission: armorstands.cmd.give

    /ds giveliest - Shows you a list of all available objects
    Permission: armorstands.cmd.give

    /ds object - a list of object commands.(/ds object help)
    Permission: armorstands.cmd.object
    • /ds object spawn - spawn an object
    Permission: armorstands.cmd.object.spawn - for the command: /ds object spawn​
    • /ds object despawn - despawn an object
    Permission: armorstands.cmd.object.despawn - for the command: /ds object despawn​
    • /ds object list - receive a list of all owned objects
    • /Ds object shop - open the shop
    • /ds object fuel - fill up petrol for a vehicle
    /ds tune <object> - Open the tune menu for a specific object
    Permission: armorstands.cmd.tune

    /ds buy <object> - Buy a specific object
    Permission: armorstands.cmd.buy

    /ds paste - Pastes your loaded scene.
    Permission: armorstands.cmd.paste

    /ds pastelist - Get a list of all available armor stands
    Permission: armorstands.cmd.paste

    /ds set- Set a value to a selected operation
    Permission: armorstands.cmd.set

    /ds spawn - spawn a mob, which doesn't move
    Permission: armorstands.cmd.spawn

    /ds spawnlist - get a list of all mobs, which you can spawn
    Permission: armorstands.cmd.spawnlist

    /ds remove - remove a clicked armor stand or a couple of armor stands
    Permission: armorstands.cmd.remove

    /ds removeall - remove all armorstands and/or static mobs (replacement for /killall)
    Permission: armorstands.cmd.removeall

    /ds undo - Removes the last pasting.
    Permission: armorstands.cmd.undo

    Permissions
    give someone the permission for:
    • all commands - armorstands.cmd.*
    • object interactions - armorstands.object.*

    • buying an object - armorstands.object.buy.type
    • buying all objects - armorstands.object.buy.type
    • tuning an object - armorstands.object.tune.type
    • tuning all objects - armorstands.object.tune.*
    • using an object - armorstands.object.use.type
    • using all objects - armorstands.object.use.*

    • Breaking armorstands with the hand - armorstands.action.remove.armorstand

    Avaible "type"(s):
    - Car
    - Motorbike
    - RacingCar
    - Vespa

    Config
    Code (Text):
    EnableAutomaticDespawn: true
    AutomaticDespawnTime: 300
    LanguageFile: lang_en.yml
    AdvancedDriveMode: true
    EggMode: false
    Enable-Metrics: true
    Enable-Fuel: true
    This is the config of DynamicStands.
    As you can see, there are 7 settings, which you can modify.

    Code (Text):
    EnableAutomaticDespawn: true
    This option is for despawning objects automatically after a specific time. (if they weren't be used)

    Code (Text):
    AutomaticDespawnTime: 300
    Here you can set the time for despawning objects.

    Code (Text):
    LanguageFile: lang_en.yml
    Here you change, which language file should be loaded by starting the server, so you can switch between several files and to make some improvements.

    Code (Text):
    AdvancedDriveMode: true
    There are two different "driving modes" of which you can choose.
    By setting it to true you will rotate your car by moving your Mouse and the keys A and D will move your car to the left and to the right.
    By setting it to false you will rotate your car by clicking the keys A and D.
    The keys W and S will always move your car to the front or to the back.
    It's your choice.

    Code (Text):
    EggMode: false
    Decide whether you want to spawn objects(like vehicles) via commands or items (spawn eggs).

    Code (Text):
    Enable-Metrics: true
    If you enable this option, you allow the plugin to send some information of the server (e.g. Java Version, Minecraft Version, ...) to a central database (mcmetrics.org).
    This is helping me by developing DynamicStands, because I can diagnose for example how useful it is to support the MC versions 1.9.

    Code (Text):
    Enable-Fuel: true
    Enable/Disable the fuel functions.
    For more informations got to the section 2.8 Fuel.

    Guide

    1.Editing
    1.1 Beginning

    At first you have to execute the command: /ds edit, because you need two tools to edit armor-stands.
    If you have executed the command, you will get a pickaxe and a book.


    [​IMG]

    The pickaxe is important to mark a group of armor stands(like for saving) or to select a single armor stand.
    The book contains the whole functions of editing a armor stand. If you make a left click with the book in your hand, a new inventory will open.

    [​IMG]

    You can see many different items, which are all representing single functions.
    You select/execute a function by clicking on an item.

    Before you can use the functions you need to select an armor stand by right clicking with the pickaxe on it.
    There should be a message in the chat:

    [​IMG]

    1.2 GUI-Functions

    At the top are three fences, which support the moving of armor stands on the three different axis(x, y, z).

    [​IMG]

    If you have selected on of the fences, you need your mouse wheel to move the armor-stands.

    If you are finished with the moving, you have to click on your book and you must click on the cancel-operation.(IMPORTANT: Don't move back to the book with your mouse wheel, because it will moving or changing the armor-stand. Just click on the number, on which the book is placed.)

    [​IMG]

    The cancel-function does what the name says. It quits every function, which needs the mouse wheel.

    [​IMG]

    In the second line is a diamond armor. With that you can add any armor tile(helmet, chest plate, leggings, boots) to your armor stand.

    [​IMG]

    The bone is for changing the visibility of arms.


    [​IMG]

    Before: After:
    [​IMG] [​IMG]

    Also setting a player's head is possible with the skull-item.(you can see in the picture the head of notch)

    [​IMG]

    Just click at the item and then write the player's name in the chat, when you get the message.

    [​IMG]

    Now we came to a special part of the plugin. The rotation of the single body parts of the armor stand.
    Just select the part, which you want to rotate(head, body, left arm, right arm, left leg, right leg).
    If you aren't sure which one is the right, you can hover with your mouse about the single tiles.
    You will get a small info.


    [​IMG]

    After you have selected a part of the armor stand, you must select the axis, which you want to rotate.
    Just try out which one is the right, you will get the right feeling after working a while.

    [​IMG]

    After that you use again your mouse wheel to rotate it.


    Sometimes it's difficult to rotate/move the armor-stand, because you only want to move it a bit.
    Then you can use the compass and the clock to set how precise the moving is.
    With the compass you enlarge the movement and with the clock you reduce the movement.

    [​IMG]

    You can set an item into the right hand of the armor-stand with the diamond-sword.
    Just click at the sword and then click at the item in your item bar.

    [​IMG]

    Since the „Combat Update“ you can also set an item to the left hand of an armor stand. Use the shield:
    [​IMG]

    Every armor stand supports two sizes(big and small).
    Normally it's in the big-size, but you can change that with the sapling.

    [​IMG]

    Little size:

    [​IMG]

    To overcome the gravity, you can use the feather. It disable the falling of armor stands,
    so you can spawn them in the air.


    [​IMG]

    Also changing the visibility is possible. But not the whole armor stand will be invisible(that will be useless), only the body parts, which aren't covered.

    [​IMG]


    If you only want to change the visibility of the base plate underneath the armor stand, you must click at the stone plate.

    [​IMG]

    Visible: Invisible:

    [​IMG] [​IMG]


    Last but not least you can also set block at the armor stand head.
    Just click at the stone block and select a block from your inventory.

    [​IMG]

    1.3 Save and Load

    To save a couple of armor stands, you have to select a region like in world edit.
    Just use the pickaxe to select two points.

    [​IMG]

    After selecting the points, you move to a position near the armor stands and execute
    the command /ds save <name>. By loading the model the armor-stands will be pasted relative to the selected position.



    To paste a model just use the command /ds load <name>.
    After that you can paste it multiple times with the command /ds paste.
    If you aren't satisfied with the pasting use the command /Ds undo.

    1.4 Mobs

    Spawning mobs is another feature and it's really simple.
    Just use the command /ds spawn <type> to spawn a mob at your location.
    To get a full list of supported mobs use the command /ds spawn list.
    The mobs will not move,attack or doing something mob-typical.

    [​IMG]

    1.5 Spawner-Eggs
    Are you tired of loading and pasting the same model again?
    Then you can use spawner-eggs.
    Just load a model once and use the command /ds combine <amount>.
    Then you get a spawner-egg, which pastes the selected model by clicking on a block.

    [​IMG]

    1.6 The copy - command
    The command („/ds copy …) seems to be simple and it is, but it is also a powerful command to create different scenes.
    Have you been ever tired of always creating the same armor stand on a different place?
    Now you can copy it and you can specify the place and the rotation.
    In cause of that it becomes very simple to create a scene of the same armor stand.

    [​IMG]

    If you are dissatisfied about the copied armor stand, you can use /ds undo.

    Here is an overview about all functions of the command:
    (1) To move the armor stand you can add an vector like: „/ds copy 0 1 0“
    The copied armor stand will move 1 block up. (negative values are accepted)
    (2) Also decimals are accepted: „/ds copy 0.5 0.25 1.5“ (use dots as decimal points)
    The copied armor stand will move a half block on the x-Axis, a quarter block up and one and a half block on the z-Axis.
    (3) To move and rotate an copied armor stand use: „/ds copy 1 1 1 22.5“
    The copied armor stand will move one block in x,y and z - Direction. Afterwards it rotates 45 degress in clock direction.
    (4) The copied armor stand will automatically be selected.
    If you don't want to select the copied armor stand you have to add "n" before the rest of the command:
    „/ds copy n 1 2 3 40“
    (5) If you are unhappy with the copied armor stand you can use „/ds undo“.
    After that your old armor stand, which was copied, will be selected.

    To get this overview you can always use „/ds copy info“.

    1.7 The set - command
    The set-command (/Ds set) is very similar to the copy-command.
    You can set fixed values(angles) to a selected operation(rotations) like head-rotation, body-rotation…
    At first you have to select an operation in the book.
    Then you can set the rotation of one or more axis by using this command.

    For example:
    /ds set x 90, will set the rotation of the x-Axis to 90 degrees.
    /ds set 90 90 90, will set the rotation of all three axis to 90 degrees.


    I think you understand it, after all the best method is learning by doing.


    2.Objects
    Since the version 1.3 are objects like cars available.
    These objects can be given to a player, who can spawn them and interact with them.


    2.1 The give - command
    If you want to give an object to a player, you can use the command: /ds give <object> <player>.
    After that he will permanently own the object and he has the possibility to spawn it.
    If you don’t know which objects are available(currently only one) you can use the command /ds giveliest.


    2.2 The object - command
    The object command is for spawning and despawning an owned object.
    For spawning: /ds object spawn <name>
    For despawning: /ds object despawn <name>

    If you forgot which objects are available for you, you can take a look in your garage. (/Ds object own list)


    2.3 Vehicles
    After you have spawned a vehicle, make a right click on it and you can driving it.

    Currently there are three different types of vehicles:

    2.3.1 Car
    [​IMG]

    2.3.2 Racing Car
    [​IMG]
    Credits to @Sturmchicken

    2.3.3 Motorbike
    [​IMG]
    Credits to @Sturmchicken

    2.3.4 Vespa
    [​IMG]
    Credits to @Sturmchicken

    2.3.5 Helicopter
    [​IMG]


    2.4 Buying/Tuning
    To buy or to tune an object you can easily use a GUI.
    Type the command „/ds object shop“ and it opens a shop - GUI.
    There you can buy objects…

    [​IMG]

    [​IMG]

    or tune them…

    [​IMG]

    The prices can be set in the config, for example:
    ColorPrice: 20
    CarPrice: 100

    Currently there is the option to change the color of your car/helicopter:

    [​IMG]

    If the user has bought the color once, he can change it, whenever he want to.


    2.5 Tuning the Speed

    [​IMG]

    Since version 1.3.4 of DynamicStands, you can also tuning the top speed.
    There are three default level of speed in the config:

    Code (Text):
    Car:
      Price:
        Object: 50.0
        Color: 20.0
      Max-Speed:
        Normal:
          Speed: 0.7
        High:
          Speed: 0.9
          Price: 200.0
        Maximum:
          Speed: 1.2
          Price: 500.0
        Level:
        - Normal
        - High
        - Maximum
     

    The config can be found with the following path: /plugins/DynamicStands/Objects/Shop-Tune.yml/

    You can change the values of the speed/price, you can remove them or add new ones, but look that on the end at least one level of speed exists. Otherwise the plugin do not work.

    Here is an example for adding a new level of speed:

    Code (Text):

    Max-Speed:
        Normal:
          Speed: 0.7
        High:
          Speed: 0.9
          Price: 200.0
        Maximum:
          Speed: 1.2
          Price: 500.0
        SpeedOfLight:
          Speed: 2.0
          Price: 20000.75
        Level:
        - Normal
        - High
        - Maximum
        - SpeedOfLight
     

    2.6 Egg-Mode
    There are two options how to manage the spawning of vehicles.
    Usually you can spawn and despawn cars and other vehicles with two commands(/ds object spawn, /ds object despawn).
    Every player will have the opportunity to only spawn one vehicle of a type at the same time.
    Also he can buy a vehicle only once and then it will be stored forever and loosing is impossible(if the data doesn't get lost).
    In the other mode(Egg-Mode), the player can buy a vehicle how often he want and he can spawn multiple vehicles of different types at the same time.
    The vehicle is bounded to an egg, so he can give it away or lose it or sell it or whatever he want to.
    [​IMG]
    The description of the egg contains the type of the vehicle and that's it.
    [​IMG]

    If you have placed a vehicle and you want to remove it, just make a right click on it, while you are sneaking.

    To change the mode you have to edit the config:
    Code (Text):
    EggMode: true
    Enable the Egg-Mode = true
    Disable the Egg-Mode = false


    This mode was added, because many users asked for such a feature, so i let you decide, which one you prefer.

    2.7 Create new Vehicles
    There are often special wishes for new vehicles, but unfortunately i haven't enough time to realize all these ideas. So I enabled you to create your own vehicles for your customized Minecraft Server.
    The creation starts with the command "/ds object create". Check whether you are in the editor mode
    (/ds edit).
    Do not leave it until you finished the vehicle.

    Use "/ds object create exit" to cancel/exit the creation mode. Note that the current state will not be saved.

    Then you can start building armor stands with all the editing tools this plugin offers.
    After you've finished working on an armor stand, don't forget to add it with: /ds add.
    It will open an inventory, where you have to specify which component this armor stand is representing.

    [​IMG]

    Basically there are five different types:

    [​IMG]
    Default - Just a normal design element.

    [​IMG]
    Collision Box - The armor stand will be part of the collision detection(the car body).

    [​IMG]
    Wheel - The selected armor stand is a wheel.

    [​IMG]
    Seat - The selected armor stand is the seat.(just one)

    [​IMG]
    Front - The selected armor stand is in the front of the seat.
    (is important for calculating the direction of driving the car)


    After you've finished adding armor stands, you have to save the vehicle:
    Use the following command: "/ds object create finish <name>".
    Note that the name must be unique(the plugin should remind you if it isn't so), because there is a file saved in the plugins folder.
    This will make it possible to share vehicles easily via exchanging files or to simply remove vehicles by removing the vehicle file after stopping the server.
    That's it.

    2.8 Fuel/Petrol

    [​IMG]

    Like in reality the vehicles of DynamicStands has a fuel bar, which shows the remaining petrol of a car, a motorbike,...
    It's getting lower by driving and you can fill it up with an command.

    [​IMG]

    Here is the command:

    [​IMG]


    By executing the command to refill your vehicle, you have to pay some money, which is defined in the config.
    You accept/refuse the transaction by clicking 'Yes' or 'No'.

    [​IMG]

    The price is adaptable in the config 'Shop-Tune.yml':
    Code (Text):
    Vespa:
      Price:
        Object: 50.0
      Max-Speed:
        ...
        Level:
        -...
      Max-Fuel: 100
      FuelPricePerLitre: 0.1
    There you can change the maximum amount of fuel for every vehicle and also the price per litre (or gallon) fuel.
    A complete refill by the current configuration would cost 10$. (Max-Fuel * FuelPricePerLitre)

    2.9 Passengers
    Some vehicles have the ability to carry more than one player. (currently it's the Vespa and the Helicopter).
    The player, who wants to join a vehicle, has just to click at it and the owner will be notified and can decide whether he will let him join or not.
    [​IMG]

    The passenger view in the Helicopter:
    [​IMG]

    On The End

    I hope that I could explain you how this plugin works. If any questions are left, you could write me a message or write a comment.


    Have a nice day and enjoy the plugin.
  • Loading...
  • Loading...