fix: fixed comments to properly display as a list

This commit is contained in:
Yannik Bretschneider 2021-05-01 23:54:25 +02:00
parent 1cb86f6be8
commit 1a33a8cb7e
1 changed files with 34 additions and 24 deletions

View File

@ -160,14 +160,16 @@ public class EventBuilder {
/**
* Builds a {@link GameEvent} from the values given to the builder
* <b>type</b> is the {@link EventType} of the {@link GameEvent}.
* <b>roundCount</b> describes the count of rounds in the RoundSetupEvent
* <b>turnCount</b> describes the amount of turns taken in Events
* <b>characterOrder</b> describes the order in which characters have their turn
* <b>nextCharacter</b> describes the next character in the turn order in the TurnEvent
* <b>playerWon</b> describes the player that has won the game in the WinEvent
* <b>message</b> describes a generic message delivered as a String in several GameEvents. It is optional.
* <b>timeLeft</b> describes the time left for a client to act before getting kicked in the TimeoutWarning event
* <ul>
* <li>type is the {@link EventType} of the {@link GameEvent}.</li>
* <li>roundCount describes the count of rounds in the RoundSetupEvent</li>
* <li>turnCount describes the amount of turns taken in Events</li>
* <li>characterOrder describes the order in which characters have their turn</li>
* <li>nextCharacter describes the next character in the turn order in the TurnEvent</li>
* <li>playerWon describes the player that has won the game in the WinEvent</li>
* <li>message describes a generic message delivered as a String in several GameEvents. It is optional.</li>
* <li>timeLeft describes the time left for a client to act before getting kicked in the TimeoutWarning event</li>
* </ul>
* @return a {@link GameEvent} based on the builder. Caution: non-given fields are null!
*/
public GameEvent buildGameEvent() {
@ -187,10 +189,12 @@ public class EventBuilder {
/**
* Builds an {@link EntityEvent} from the values given to the builder.
* <b>type</b> is the {@link EventType} of the EntityEvent
* <b>targetEntity</b> is the target {@link Entity}
* <b>targetField</b> is the target field in the form of an {@link IntVector2}
* <b>amount</b> is the amount of something, like damage. It's an int.
* <ul>
* <li>type is the {@link EventType} of the EntityEvent</li>
* <li>targetEntity is the target {@link Entity}</li>
* <li>targetField is the target field in the form of an {@link IntVector2}</li>
* <li>amount is the amount of something, like damage. It's an int.</li>
* </ul>
* @return a {@link EntityEvent} based on the builder. Caution: non-given fields are null!
*/
public EntityEvent buildEntityEvent() {
@ -204,11 +208,13 @@ public class EventBuilder {
/**
* Builds a {@link CharacterEvent} from the values given to the builder.
* <b>type</b> is the {@link EventType} of the EntityEvent
* <b>originEntity</b> is the origin {@link Entity}
* <b>targetEntity</b> is the target {@link Entity}
* <b>originField</b> is the field that an action originates in, delivered as an {@link IntVector2}
* <b>targetField</b> is the target field in the form of an {@link IntVector2}
* <ul>
* <li>type is the {@link EventType} of the EntityEvent</li>
* <li>originEntity is the origin {@link Entity}</li>
* <li>targetEntity is the target {@link Entity}</li>
* <li>originField is the field that an action originates in, delivered as an {@link IntVector2}</li>
* <li>targetField is the target field in the form of an {@link IntVector2}</li>
* </ul>
* @return a {@link CharacterEvent} based on the builder. Caution: non-given fields are null!
*/
public CharacterEvent buildCharacterEvent() {
@ -225,11 +231,13 @@ public class EventBuilder {
/**
* Builds a {@link GameStateEvent} from the values given to the builder.
* <b>type</b> is the {@link EventType} of the {@link GameStateEvent}
* <b>entities</b> is an array of {@link Entity Entities}
* <b>turnOrder</b> describes the order in which characters take turns
* <b>activeCharacter</b> describes the currently active character
* <b>describes</b> whether the win condition is in effect
* <ul>
* <li>type is the {@link EventType} of the {@link GameStateEvent}</li>
* <li>entities is an array of {@link Entity Entities}</li>
* <li>turnOrder describes the order in which characters take turns</li>
* <li>activeCharacter describes the currently active character</li>
* <li>describes whether the win condition is in effect</li>
* </ul>
* @return a {@link GameStateEvent} based on the builder. Caution: non-given fields are null!
*/
public GameStateEvent buildGamestateEvent() {
@ -244,8 +252,10 @@ public class EventBuilder {
/**
* Builds a {@link CustomEvent} from the values given to the builder
* <b>teamIdentifier</b> is a String for identifying a specific custom content
* <b>customContent</b> is a {@link HashMap}<{@link String}, {@link Object}> resembling the JSON keys in the event
* <ul>
* <li>teamIdentifier is a String for identifying a specific custom content</li>
* <li>customContent is a {@link HashMap}<{@link String}, {@link Object}> resembling the JSON keys in the event</li>
* </ul>
* @return a {@link CustomEvent} based on the builder. Caution: non-given fields are null!
*/
public CustomEvent buildCustomEvent() {