Update spawner/vault documentation to clarify distance value is not squared

This commit is contained in:
md_5 2024-12-14 11:39:29 +11:00
parent c0302c1911
commit 8c69edd891
No known key found for this signature in database
GPG key ID: E8E901AC7C617C11
3 changed files with 16 additions and 16 deletions

View file

@ -28,7 +28,7 @@ public interface TrialSpawner extends TileState {
public void setCooldownLength(int ticks); public void setCooldownLength(int ticks);
/** /**
* Get the maximum distance(squared) a player can be in order for this * Get the maximum distance a player can be in order for this
* spawner to be active. * spawner to be active.
* <br> * <br>
* If this value is less than or equal to 0, this spawner is always active * If this value is less than or equal to 0, this spawner is always active
@ -36,19 +36,19 @@ public interface TrialSpawner extends TileState {
* <br> * <br>
* Default value is 16. * Default value is 16.
* *
* @return the maximum distance(squared) a player can be in order for this * @return the maximum distance a player can be in order for this
* spawner to be active. * spawner to be active.
*/ */
public int getRequiredPlayerRange(); public int getRequiredPlayerRange();
/** /**
* Set the maximum distance (squared) a player can be in order for this * Set the maximum distance a player can be in order for this
* spawner to be active. * spawner to be active.
* <br> * <br>
* Setting this value to less than or equal to 0 will make this spawner * Setting this value to less than or equal to 0 will make this spawner
* always active (given that there are players online). * always active (given that there are players online).
* *
* @param requiredPlayerRange the maximum distance (squared) a player can be * @param requiredPlayerRange the maximum distance a player can be
* in order for this spawner to be active. * in order for this spawner to be active.
*/ */
public void setRequiredPlayerRange(int requiredPlayerRange); public void setRequiredPlayerRange(int requiredPlayerRange);

View file

@ -13,37 +13,37 @@ import org.jetbrains.annotations.Nullable;
public interface Vault extends TileState { public interface Vault extends TileState {
/** /**
* Gets the distance(squared) at which a player must enter for this vault to * Gets the distance at which a player must enter for this vault to
* activate. * activate.
* *
* @return the distance(squared) at which a player must enter for this vault * @return the distance at which a player must enter for this vault
* to activate. * to activate.
*/ */
double getActivationRange(); double getActivationRange();
/** /**
* Sets the distance(squared) at which a player must enter for this vault to * Sets the distance at which a player must enter for this vault to
* activate. * activate.
* *
* @param range the distance(squared) at which a player must enter for this * @param range the distance at which a player must enter for this
* vault to activate. * vault to activate.
*/ */
void setActivationRange(double range); void setActivationRange(double range);
/** /**
* Gets the distance(squared) at which a player must exit for the vault to * Gets the distance at which a player must exit for the vault to
* deactivate. * deactivate.
* *
* @return the distance(squared) at which a player must exit for the vault * @return the distance at which a player must exit for the vault
* to deactivate. * to deactivate.
*/ */
double getDeactivationRange(); double getDeactivationRange();
/** /**
* Sets the distance(squared) at which a player must exit for this vault to * Sets the distance at which a player must exit for this vault to
* deactivate. * deactivate.
* *
* @param range the distance(squared) at which a player must exit for this * @param range the distance at which a player must exit for this
* vault to deactivate. * vault to deactivate.
*/ */
void setDeactivationRange(double range); void setDeactivationRange(double range);

View file

@ -50,7 +50,7 @@ public interface BaseSpawner {
public void setDelay(int delay); public void setDelay(int delay);
/** /**
* Get the maximum distance(squared) a player can be in order for this * Get the maximum distance a player can be in order for this
* spawner to be active. * spawner to be active.
* <br> * <br>
* If this value is less than or equal to 0, this spawner is always active * If this value is less than or equal to 0, this spawner is always active
@ -58,19 +58,19 @@ public interface BaseSpawner {
* <br> * <br>
* Default value is 16. * Default value is 16.
* *
* @return the maximum distance(squared) a player can be in order for this * @return the maximum distance a player can be in order for this
* spawner to be active. * spawner to be active.
*/ */
public int getRequiredPlayerRange(); public int getRequiredPlayerRange();
/** /**
* Set the maximum distance (squared) a player can be in order for this * Set the maximum distance a player can be in order for this
* spawner to be active. * spawner to be active.
* <br> * <br>
* Setting this value to less than or equal to 0 will make this spawner * Setting this value to less than or equal to 0 will make this spawner
* always active (given that there are players online). * always active (given that there are players online).
* *
* @param requiredPlayerRange the maximum distance (squared) a player can be * @param requiredPlayerRange the maximum distance a player can be
* in order for this spawner to be active. * in order for this spawner to be active.
*/ */
public void setRequiredPlayerRange(int requiredPlayerRange); public void setRequiredPlayerRange(int requiredPlayerRange);