Preparing to resume development of SG-Command

This commit is contained in:
Pheotis
2021-07-01 20:11:18 -04:00
parent e21adda6bd
commit 6870f08614
2 changed files with 47 additions and 42 deletions

85
README
View File

@@ -1,47 +1,53 @@
============= > !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!<br>
Updates > THIS ADDON IS A **WORK IN PROGRESS**.<br>DO __**NOT**__ USE IT ON PRODUCTION INSTANCES<br><br>
============= > No stable releases are available at this time.<br>
Please visit http://forum.thedgtl.net for all updates and support! > !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!<br>
=============
Description
=============
StargateCommand is an addon for Stargate that adds three very useful commands: import, export, and dial.
============= > Please visit [our discord](https://discord.gg/mTaHuK6BVa) for all updates and support!
Dependencies
=============
Stargate v0.7.8.0 -- http://thedgtl.net/bukkit/
============= # Description
Permissions StargateCommand is an addon for Stargate that allows users to interact with Stargate with commands.
=============
stargate.command.import -- Allow the use of /sgc import (Default: Op)
stargate.command.export -- Allow the use of /sgc export (Default: Op)
stargate.command.dial -- Allow the use of /dial (Default: True)
stargate.command.dial.interactive -- Allow use of /dial <dest> (Default: True)
stargate.command.dial.direct -- Allow use of /dial <src> <dest> (Default: False)
============= #### Features:
Default Permissions ##### Import
============= Places a specified `.gate` file in-game.
##### Export
Saves your selection to file as a `.gate`
##### Dial
Specifies your destination for networked gates.
## Dependencies
[The most recent version of Stargate](https://www.spigotmc.org/resources/stargate.87978/)
# Permissions
### Nodes
```
stargate.command.import -- Allow the use of /sgc import
stargate.command.export -- Allow the use of /sgc export
stargate.command.dial -- Allow the use of /dial
stargate.command.dial.interactive -- Allow use of /dial <dest>
stargate.command.dial.direct -- Allow use of /dial <src> <dest>
```
### Defaults
```
stargate.command.import -- Op stargate.command.import -- Op
stargate.command.export -- Op stargate.command.export -- Op
stargate.command.dial -- True stargate.command.dial -- True
stargate.command.dial.interactive -- True stargate.command.dial.interactive -- True
stargate.command.dial.direct -- False stargate.command.dial.direct -- False
```
## Instructions
### Import
=============
Import
=============
The "/sgc import" command allows you to import a .gate file without having to manually build it. To import a gate you simply type: The "/sgc import" command allows you to import a .gate file without having to manually build it. To import a gate you simply type:
/sgc import <gatefile> `/sgc import <gatefile>`
Where <gatefile> is any .gate file without ".gate" at the end. You will then be asked to select two blocks next to each other by right clicking them, this specifies the gates bottom-left location, and orientation. Where <gatefile> is any .gate file without ".gate" at the end. You will then be asked to select two blocks next to each other by right clicking them, this specifies the gates bottom-left location, and orientation.
You can see an example of importing a gate in this YouTube video: http://youtu.be/Y7KQ0wUUP8c You can see an example of importing a gate in [this YouTube video](http://youtu.be/Y7KQ0wUUP8c).
============= ### Export
Export
=============
The "/sgc export" command is slightly more complicated than importing, but will allow you to take a gate layout ingame, and export it to a .gate file without having to hand-edit the file. The "/sgc export" command is slightly more complicated than importing, but will allow you to take a gate layout ingame, and export it to a .gate file without having to hand-edit the file.
The first step in building a gate for export is creating a frame out of bedrock material, everything inside of this frame will be treated as the gate, and any bedrock inside of this frame will be treated as the entrance/exit. The first step in building a gate for export is creating a frame out of bedrock material, everything inside of this frame will be treated as the gate, and any bedrock inside of this frame will be treated as the entrance/exit.
Once you have your bedrock frame created, make any shape with any blocks inside of the frame, here is an example export frame: Export Frame Once you have your bedrock frame created, make any shape with any blocks inside of the frame, here is an example export frame: Export Frame
@@ -54,26 +60,25 @@ The second block is where the button will be drawn
The third block is where the player will exit the gate The third block is where the player will exit the gate
The last block is the top-left of the bedrock frame The last block is the top-left of the bedrock frame
Once you have selected these four blocks, if there were no errors, your gate will be saved to disk, and loaded into memory for instant use. Once you have selected these four blocks, if there were no errors, your gate will be saved to disk, and loaded into memory for instant use.
You can see an example of exporting a gate in this YouTube video: http://youtu.be/-U6IVWt43qw You can see an example of exporting a gate in [this YouTube video](http://youtu.be/-U6IVWt43qw).
============ ### Dial
dial
============
The "/dial" command allows players to select a destination for a Stargate without requiring them to scroll through a large list of destinations. There are two modes to the /dial command. The "/dial" command allows players to select a destination for a Stargate without requiring them to scroll through a large list of destinations. There are two modes to the /dial command.
> Interactive > Interactive
The interactive mode is invoked with the command: The interactive mode is invoked with the command:
/dial <destination> `/dial <destination>`
This will make the next gate the player activates dial the given destination if available. This will make the next gate the player activates dial the given destination if available.
> Direct > Direct
Direct dialing is used to open a gate directly to another without requiring the player to interact with the gate, it is invoked as such: Direct dialing is used to open a gate directly to another without requiring the player to interact with the gate, it is invoked as such:
/dial <source> <destination> <network> `/dial <source> <destination> <network>`
If the network is not supplied, the default Stargate network will be used. If the source/destination exist on the same network, and the player has access to them, the gates will be opened with a connection to eachother. If the network is not supplied, the default Stargate network will be used. If the source/destination exist on the same network, and the player has access to them, the gates will be opened with a connection to eachother.
============= ## Configuration
Changes Not yet available.
=============
# Changes
[Version 0.0.4] [Version 0.0.4]
- Fix for Bukkit's direction fix - Fix for Bukkit's direction fix
[Version 0.0.3] [Version 0.0.3]

View File

@@ -4,7 +4,7 @@ version: 0.0.4
description: Command addon for the Stargate plugin for Bukkit description: Command addon for the Stargate plugin for Bukkit
author: Drakia author: Drakia
depend: [Stargate] depend: [Stargate]
website: http://www.thedgtl.net website: https://discord.gg/mTaHuK6BVa
commands: commands:
sgc: sgc:
description: StargateCommand import/export/owner commands. description: StargateCommand import/export/owner commands.