Package net.glowstone.scheduler

This package contains the core of Glowstone's threading model.

See: Description

Class Summary

Class	Description
GlowScheduler	A scheduler for managing server ticks, Bukkit tasks, and other synchronization.
GlowTask	Represents a task which is executed periodically.
PulseTask
WorldScheduler	Manager for world thread pool.

Package net.glowstone.scheduler Description

This package contains the core of Glowstone's threading model.

Glowstone has 4 groups of threads:

• World threads. One thread per world
• Event/scheduler thread. This thread contains all interaction with Bukkit API and synchronizes all other threads.
• Async task thread pool. Pool of threads used to execute async tasks
• Netty thread pool. This thread pool is used by Netty for network read/write

Whenever a thread wishes to call an event or perform other interactions with Bukkit API, it calls the GlowScheduler.syncIfNeeded( java.util.concurrent.Callable).

The scheduler thread synchronizes the world threads, so that each world thread begins a tick at the beginning of a scheduler pulse.

Operation order:

1. Scheduler tick begins
2. Pulse sessions
3. run sync tasks, queue async tasks
4. World tick for each world
5. Run in-tick tasks
6. await all worlds complete (in async task)