Difference between revisions of "Plugin channels/World downloader"

From wiki.vg
Jump to navigation Jump to search
m (→‎Basic data: Typing)
(Add packets 2 and 3)
Line 103: Line 103:
 
  | Boolean
 
  | Boolean
 
  | True to allow the mod to save containers (a subset of tile entities that require manual interaction to be saved, mainly chests).  This only applies if tile entities are allowed to be saved and only applies in chunks that can be saved.
 
  | True to allow the mod to save containers (a subset of tile entities that require manual interaction to be saved, mainly chests).  This only applies if tile entities are allowed to be saved and only applies in chunks that can be saved.
 +
|}
 +
 +
=== Entity track distances ===
 +
 +
Used to specify any custom entity track distances on the server, because they may change on spigot servers.  More info on why this is needed on [https://github.com/Pokechu22/WorldDownloader/wiki/Entities-GUI#what-are-track-distances the project wiki].
 +
 +
The client is free to ignore these values, and will use sane defaults based off of whether the server's brand includes "spigot" if they are not sent.  However, by default these values are used.
 +
 +
{| class="wikitable"
 +
! Channel
 +
! Bound To
 +
! colspan="2" | Field Name
 +
! colspan="2" | Field Type
 +
! Notes
 +
|-
 +
| rowspan="4" | <code>WDL|CONTROL</code>
 +
| rowspan="4" | Client
 +
| colspan="2" | Discriminator
 +
| colspan="2" | Integer
 +
| Set to 2 to indicate this packet.
 +
|-
 +
| colspan="2" | Number of ranges
 +
| colspan="2" | Integer
 +
| Size of the following array.
 +
|-
 +
| rowspan="2" | Values
 +
| Entity name
 +
| rowspan="2" | Array
 +
| String
 +
| The name of the entity, as used in the savegame ID.
 +
|-
 +
| Track distance
 +
| Integer
 +
| The track distance of the entity, in blocks.
 +
|}
 +
 +
=== Permission request info ===
 +
 +
Information used with permission requests.
 +
 +
{| class="wikitable"
 +
! Channel
 +
! Bound to
 +
! Field Name
 +
! Field Type
 +
! Notes
 +
|-
 +
| rowspan="3" | <code>WDL|CONTROL</code>
 +
| rowspan="3" | Client
 +
| Discriminator
 +
| Integer
 +
| Set to 3 to indicate this packet.
 +
|-
 +
| Requests enabled
 +
| Boolean
 +
| Whether requests work on this server.  In '''all cases''' this should be true unless you have an out of date plugin... in which case you probably wouldn't be sending this anyways.
 +
|-
 +
| Request message
 +
| String
 +
| A message displayed to players on the permissions and permissions request screen.  You can use this to display rules relating to use of the mod, or explain how you want it to be used, or what info to include in the request, etc.
 
  |}
 
  |}
  

Revision as of 20:02, 25 January 2016

Work in progress!

This page is a work in progress, and may be missing information.

Documentation of the World Downloader mod's plugin channel configuration system.

See here.

Note

All types here are as specified by Java's DataOutputStream and can be read using a DataInputStream, unless otherwise noted.

WDL|INIT

WDL|INIT is sent to show that World Downloader is ready to receive new permissions. Don't send permissions until this is received - it may still be saving from another part of the map or another sever where it has permission, and revoking permission in the middle is a Bad Thing™.

Bound To Field Name Field Type Notes
Server Mod version UTF8 string This is a byte array; the remainder of the packet is this value (there is no length specified). In some older versions of the mod, this is not present and the length of the packet is 0.

WDL|CONTROL

This channel is sent from the server to the client to specify various permissions. It uses a 4-byte integer at the start to indicate a section. There is no required order, but it is conventional to put them in numerical order.

In all cases unless otherwise indicated, if a packet is not sent its values are treated as 'true'.

Default values

Specifies the default value used for permissions not sent.

Note that sending this packet does not actually change the value for other packets; it instead specifies an internal fallback. Thus, this packet can be sent at any time to change this default without needing to resend other packets.

Channel Bound To Field Name Field Type Notes
WDL|CONTROL Client Discriminator Integer Set to 0 to indicate this packet.
Default value Boolean True to enable all functions not otherwise specified, false to disable them.

Basic data

Sets some of the standard properties.

Channel Bound To Field Name Field Type Notes
WDL|CONTROL Client Discriminator Integer Set to 1 to indicate this packet.
General download enabled Boolean True to enable all downloading in all chunks, false to disable it.
Save radius Integer The distance from the player chunks can be saved from. -1 to allow all distances. This is a square distance, not a circle or a diamond. Only applies if chunk caching is disabled.
Chunk caching enabled Boolean Can chunks be saved as the player moves about. If false, then they can only save within the area indicated by save radius; if true they can save everywhere. However, regardless of this value, if general download is disabled, they cannot download.
Entity saving enabled Boolean True to allow the mod to save entities, false to force entities to be removed from the world. This only applies to chunks that can be saved.
Tile entity saving enabled Boolean True to allow the mod to save tile entities, false to force tile entities to be removed from the world. This only applies to chunks that can be saved.
Container saving enabled Boolean True to allow the mod to save containers (a subset of tile entities that require manual interaction to be saved, mainly chests). This only applies if tile entities are allowed to be saved and only applies in chunks that can be saved.

Entity track distances

Used to specify any custom entity track distances on the server, because they may change on spigot servers. More info on why this is needed on the project wiki.

The client is free to ignore these values, and will use sane defaults based off of whether the server's brand includes "spigot" if they are not sent. However, by default these values are used.

Channel Bound To Field Name Field Type Notes
WDL|CONTROL Client Discriminator Integer Set to 2 to indicate this packet.
Number of ranges Integer Size of the following array.
Values Entity name Array String The name of the entity, as used in the savegame ID.
Track distance Integer The track distance of the entity, in blocks.

Permission request info

Information used with permission requests.

Channel Bound to Field Name Field Type Notes
WDL|CONTROL Client Discriminator Integer Set to 3 to indicate this packet.
Requests enabled Boolean Whether requests work on this server. In all cases this should be true unless you have an out of date plugin... in which case you probably wouldn't be sending this anyways.
Request message String A message displayed to players on the permissions and permissions request screen. You can use this to display rules relating to use of the mod, or explain how you want it to be used, or what info to include in the request, etc.

WDL|REQUEST

Used for permission requests.