Upstream/Minestom
1
0
Fork 0
mirror of https://github.com/Minestom/Minestom.git synced 2025-03-02 11:21:15 +01:00
Code Issues Projects Releases Wiki Activity

Added more Instance comments

Browse Source
This commit is contained in:
themode 2020-09-19 19:06:21 +02:00
parent c43064c3a0
commit 4c93450520
2 changed files with 24 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
src/main/java/net/minestom/server/entity/Player.java
View File

@ -572,7 +572,7 @@ public class Player extends LivingEntity implements CommandSender {
final int chunkX = ChunkUtils.getChunkCoordX(visibleChunk);
final int chunkZ = ChunkUtils.getChunkCoordZ(visibleChunk);
ChunkCallback callback = (chunk) -> {
final ChunkCallback callback = (chunk) -> {
if (chunk != null) {
chunk.addViewer(this);
if (chunk.getChunkX() == Math.floorDiv((int) getPosition().getX(), 16) && chunk.getChunkZ() == Math.floorDiv((int) getPosition().getZ(), 16))

25
src/main/java/net/minestom/server/instance/Instance.java
View File

@ -20,6 +20,7 @@ import net.minestom.server.network.PacketWriterUtils;
import net.minestom.server.network.packet.server.play.BlockActionPacket;
import net.minestom.server.network.packet.server.play.TimeUpdatePacket;
import net.minestom.server.storage.StorageLocation;
import net.minestom.server.thread.ThreadProvider;
import net.minestom.server.utils.BlockPosition;
import net.minestom.server.utils.Position;
import net.minestom.server.utils.chunk.ChunkCallback;
@ -94,6 +95,12 @@ public abstract class Instance implements BlockModifier, EventHandler, DataConta
this.worldBorder = new WorldBorder(this);
}
/**
* Schedule a task to be run during the next instance tick
* It ensures that the task will be executed in the same thread as the instance and its chunks/entities (depending of the {@link ThreadProvider})
*
* @param callback the task to execute during the next instance tick
*/
public void scheduleNextTick(Consumer<Instance> callback) {
nextTick.add(callback);
}
@ -364,6 +371,11 @@ public abstract class Instance implements BlockModifier, EventHandler, DataConta
this.timeUpdate = timeUpdate;
}
/**
* Get a {@link TimeUpdatePacket} with the current age and time of this instance
*
* @return the {@link TimeUpdatePacket} with this instance datal
*/
private TimeUpdatePacket getTimePacket() {
TimeUpdatePacket timeUpdatePacket = new TimeUpdatePacket();
timeUpdatePacket.worldAge = worldAge;
@ -574,6 +586,14 @@ public abstract class Instance implements BlockModifier, EventHandler, DataConta
return getCustomBlock(blockPosition.getX(), blockPosition.getY(), blockPosition.getZ());
}
/**
* Send a {@link BlockActionPacket} for all the viewers of the specific position
*
* @param blockPosition
* @param actionId
* @param actionParam
* @see <a href="https://wiki.vg/Protocol#Block_Action">Packet information</a> for the action id & param
*/
public void sendBlockAction(BlockPosition blockPosition, byte actionId, byte actionParam) {
final short blockStateId = getBlockStateId(blockPosition);
final Block block = Block.fromStateId(blockStateId);
@ -883,7 +903,8 @@ public abstract class Instance implements BlockModifier, EventHandler, DataConta
/**
* Performs a single tick in the instance.
* By default, does nothing
* <p>
* Warning: this does not update chunks and entities
*
* @param time the current time
*/
@ -943,7 +964,7 @@ public abstract class Instance implements BlockModifier, EventHandler, DataConta
}
/**
* Return the registered explosion supplier, or null if none was provided
* Return the registered {@link ExplosionSupplier}, or null if none was provided
*
* @return the instance explosion supplier, null if none was provided
*/