net.minecraftforge.common

Class ForgeChunkManager

java.lang.Object

net.minecraftforge.common.ForgeChunkManager

public class ForgeChunkManager
extends java.lang.Object

Manages chunkloading for mods. The basic principle is a ticket based system. 1. Mods register a callback setForcedChunkLoadingCallback(Object, LoadingCallback) 2. Mods ask for a ticket requestTicket(Object, World, Type) and then hold on to that ticket. 3. Mods request chunks to stay loaded forceChunk(Ticket, ChunkPos) or remove chunks from force loading unforceChunk(Ticket, ChunkPos). 4. When a world unloads, the tickets associated with that world are saved by the chunk manager. 5. When a world loads, saved tickets are offered to the mods associated with the tickets. The ForgeChunkManager.Ticket.getModData() that is set by the mod should be used to re-register chunks to stay loaded (and maybe take other actions). The chunkloading is configurable at runtime. The file "config/forgeChunkLoading.cfg" contains both default configuration for chunkloading, and a sample individual mod specific override section.

Author:

cpw

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	ForgeChunkManager.ChunkEntry
static class	ForgeChunkManager.ForceChunkEvent
static interface	ForgeChunkManager.LoadingCallback All mods requiring chunkloading need to implement this to handle the re-registration of chunk tickets at world loading time
static interface	ForgeChunkManager.OrderedLoadingCallback This is a special LoadingCallback that can be implemented as well as the LoadingCallback to provide access to additional behaviour.
static interface	ForgeChunkManager.PlayerOrderedLoadingCallback
static class	ForgeChunkManager.Ticket
static class	ForgeChunkManager.Type
static class	ForgeChunkManager.UnforceChunkEvent

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	asyncChunkLoading
private static java.util.Map<java.lang.String,ForgeChunkManager.LoadingCallback>	callbacks
private static java.io.File	cfgFile
private static java.util.Map<java.lang.String,java.lang.Integer>	chunkConstraints
private static Configuration	config
private static int	defaultMaxChunks
private static int	defaultMaxCount
private static java.util.Map<World,com.google.common.cache.Cache<java.lang.Long,ForgeChunkManager.ChunkEntry>>	dormantChunkCache
private static int	dormantChunkCacheSize
private static java.util.Map<World,com.google.common.collect.ImmutableSetMultimap<ChunkPos,ForgeChunkManager.Ticket>>	forcedChunks
static java.util.List<java.lang.String>	MOD_PROP_ORDER
private static boolean	overridesEnabled
private static com.google.common.collect.BiMap<java.util.UUID,ForgeChunkManager.Ticket>	pendingEntities
private static int	playerTicketLength
private static com.google.common.collect.SetMultimap<java.lang.String,ForgeChunkManager.Ticket>	playerTickets
private static java.util.Map<java.lang.String,java.lang.Integer>	ticketConstraints
private static java.util.Map<World,com.google.common.collect.Multimap<java.lang.String,ForgeChunkManager.Ticket>>	tickets
private static java.util.Set<java.lang.String>	warnedMods

Constructor Summary

Constructors

Constructor and Description
ForgeChunkManager()

Method Summary

Modifier and Type	Method and Description
static void	addConfigProperty(java.lang.Object mod, java.lang.String propertyName, java.lang.String value, Property.Type type)
(package private) static void	captureConfig(java.io.File configDir)
static Chunk	fetchDormantChunk(long coords, World world)
static void	forceChunk(ForgeChunkManager.Ticket ticket, ChunkPos chunk) Force the supplied chunk coordinate to be loaded by the supplied ticket.
static Configuration	getConfig()
static ConfigCategory	getConfigFor(java.lang.Object mod)
private static ModContainer	getContainer(java.lang.Object mod)
static ConfigCategory	getDefaultsCategory()
static int	getMaxChunkDepthFor(java.lang.String modId)
static int	getMaxTicketLengthFor(java.lang.String modId)
static java.util.List<ConfigCategory>	getModCategories()
static com.google.common.collect.ImmutableSetMultimap<ChunkPos,ForgeChunkManager.Ticket>	getPersistentChunksFor(World world) The list of persistent chunks in the world.
static java.util.Iterator<Chunk>	getPersistentChunksIterableFor(World world, java.util.Iterator<Chunk> chunkIterator)
private static void	loadChunkEntities(Chunk chunk, NBTTagCompound nbt, World world)
(package private) static void	loadConfiguration()
(package private) static void	loadEntity(Entity entity)
(package private) static void	loadWorld(World world)
static void	putDormantChunk(long coords, Chunk chunk)
static void	releaseTicket(ForgeChunkManager.Ticket ticket) Release the ticket back to the system.
static void	reorderChunk(ForgeChunkManager.Ticket ticket, ChunkPos chunk) Reorganize the internal chunk list so that the chunk supplied is at the *end* of the list This helps if you wish to guarantee a certain "automatic unload ordering" for the chunks in the ticket list
static ForgeChunkManager.Ticket	requestPlayerTicket(java.lang.Object mod, java.lang.String player, World world, ForgeChunkManager.Type type)
static ForgeChunkManager.Ticket	requestTicket(java.lang.Object mod, World world, ForgeChunkManager.Type type) Request a chunkloading ticket of the appropriate type for the supplied mod
static boolean	savedWorldHasForcedChunkTickets(java.io.File chunkDir) Allows dynamically loading world mods to test if there are chunk tickets in the world Mods that add dynamically generated worlds (like Mystcraft) should call this method to determine if the world should be loaded during server starting.
(package private) static void	saveWorld(World world)
static void	setForcedChunkLoadingCallback(java.lang.Object mod, ForgeChunkManager.LoadingCallback callback) Set a chunkloading callback for the supplied mod object
static void	storeChunkNBT(Chunk chunk, NBTTagCompound nbt)
static void	syncConfigDefaults() Synchronizes the local fields with the values in the Configuration object.
static int	ticketCountAvailableFor(java.lang.Object mod, World world) Discover the available tickets for the mod in the world
static int	ticketCountAvailableFor(java.lang.String username)
static void	unforceChunk(ForgeChunkManager.Ticket ticket, ChunkPos chunk) Unforce the supplied chunk, allowing it to be unloaded and stop ticking.
(package private) static void	unloadWorld(World world)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

defaultMaxCount

private static int defaultMaxCount

defaultMaxChunks

private static int defaultMaxChunks

overridesEnabled

private static boolean overridesEnabled

tickets

private static java.util.Map<World,com.google.common.collect.Multimap<java.lang.String,ForgeChunkManager.Ticket>> tickets

ticketConstraints

private static java.util.Map<java.lang.String,java.lang.Integer> ticketConstraints

chunkConstraints

private static java.util.Map<java.lang.String,java.lang.Integer> chunkConstraints

playerTickets

private static com.google.common.collect.SetMultimap<java.lang.String,ForgeChunkManager.Ticket> playerTickets

callbacks

private static java.util.Map<java.lang.String,ForgeChunkManager.LoadingCallback> callbacks

forcedChunks

private static java.util.Map<World,com.google.common.collect.ImmutableSetMultimap<ChunkPos,ForgeChunkManager.Ticket>> forcedChunks

pendingEntities

private static com.google.common.collect.BiMap<java.util.UUID,ForgeChunkManager.Ticket> pendingEntities

dormantChunkCache

private static java.util.Map<World,com.google.common.cache.Cache<java.lang.Long,ForgeChunkManager.ChunkEntry>> dormantChunkCache

cfgFile

private static java.io.File cfgFile

config

private static Configuration config

playerTicketLength

private static int playerTicketLength

dormantChunkCacheSize

private static int dormantChunkCacheSize

asyncChunkLoading

public static boolean asyncChunkLoading

MOD_PROP_ORDER

public static final java.util.List<java.lang.String> MOD_PROP_ORDER

warnedMods

private static java.util.Set<java.lang.String> warnedMods

Constructor Detail

ForgeChunkManager

public ForgeChunkManager()

Method Detail

getPersistentChunksIterableFor

public static java.util.Iterator<Chunk> getPersistentChunksIterableFor(World world,
                                                                       java.util.Iterator<Chunk> chunkIterator)

savedWorldHasForcedChunkTickets

public static boolean savedWorldHasForcedChunkTickets(java.io.File chunkDir)

Allows dynamically loading world mods to test if there are chunk tickets in the world Mods that add dynamically generated worlds (like Mystcraft) should call this method to determine if the world should be loaded during server starting.

Parameters:

chunkDir - The chunk directory to test: should be equivalent to WorldServer.getChunkSaveLocation()

Returns:

if there are tickets outstanding for this world or not

loadWorld

static void loadWorld(World world)

unloadWorld

static void unloadWorld(World world)

setForcedChunkLoadingCallback

public static void setForcedChunkLoadingCallback(java.lang.Object mod,
                                                 ForgeChunkManager.LoadingCallback callback)

Set a chunkloading callback for the supplied mod object

Parameters:

mod - The mod instance registering the callback

callback - The code to call back when forced chunks are loaded

ticketCountAvailableFor

public static int ticketCountAvailableFor(java.lang.Object mod,
                                          World world)

Discover the available tickets for the mod in the world

Parameters:

mod - The mod that will own the tickets

world - The world

Returns:

The count of tickets left for the mod in the supplied world

getContainer

private static ModContainer getContainer(java.lang.Object mod)

getMaxTicketLengthFor

public static int getMaxTicketLengthFor(java.lang.String modId)

getMaxChunkDepthFor

public static int getMaxChunkDepthFor(java.lang.String modId)

ticketCountAvailableFor

public static int ticketCountAvailableFor(java.lang.String username)

requestPlayerTicket

@Nullable
public static ForgeChunkManager.Ticket requestPlayerTicket(java.lang.Object mod,
                                                                     java.lang.String player,
                                                                     World world,
                                                                     ForgeChunkManager.Type type)

requestTicket

@Nullable
public static ForgeChunkManager.Ticket requestTicket(java.lang.Object mod,
                                                               World world,
                                                               ForgeChunkManager.Type type)

Request a chunkloading ticket of the appropriate type for the supplied mod

Parameters:

mod - The mod requesting a ticket

world - The world in which it is requesting the ticket

type - The type of ticket

Returns:

A ticket with which to register chunks for loading, or null if no further tickets are available

releaseTicket

public static void releaseTicket(ForgeChunkManager.Ticket ticket)

Release the ticket back to the system. This will also unforce any chunks held by the ticket so that they can be unloaded and/or stop ticking.

Parameters:

ticket - The ticket to release

forceChunk

public static void forceChunk(ForgeChunkManager.Ticket ticket,
                              ChunkPos chunk)

Force the supplied chunk coordinate to be loaded by the supplied ticket. If the ticket's ForgeChunkManager.Ticket.maxDepth is exceeded, the least recently registered chunk is unforced and may be unloaded. It is safe to force the chunk several times for a ticket, it will not generate duplication or change the ordering.

Parameters:

ticket - The ticket registering the chunk

chunk - The chunk to force

reorderChunk

public static void reorderChunk(ForgeChunkManager.Ticket ticket,
                                ChunkPos chunk)

Reorganize the internal chunk list so that the chunk supplied is at the *end* of the list This helps if you wish to guarantee a certain "automatic unload ordering" for the chunks in the ticket list

Parameters:

ticket - The ticket holding the chunk list

chunk - The chunk you wish to push to the end (so that it would be unloaded last)

unforceChunk

public static void unforceChunk(ForgeChunkManager.Ticket ticket,
                                ChunkPos chunk)

Unforce the supplied chunk, allowing it to be unloaded and stop ticking.

Parameters:

ticket - The ticket holding the chunk

chunk - The chunk to unforce

loadConfiguration

static void loadConfiguration()

getPersistentChunksFor

public static com.google.common.collect.ImmutableSetMultimap<ChunkPos,ForgeChunkManager.Ticket> getPersistentChunksFor(World world)

The list of persistent chunks in the world. This set is immutable.

Parameters:

world -

Returns:

the list of persistent chunks in the world

saveWorld

static void saveWorld(World world)

loadEntity

static void loadEntity(Entity entity)

putDormantChunk

public static void putDormantChunk(long coords,
                                   Chunk chunk)

storeChunkNBT

public static void storeChunkNBT(Chunk chunk,
                                 NBTTagCompound nbt)

fetchDormantChunk

@Nullable
public static Chunk fetchDormantChunk(long coords,
                                                World world)

loadChunkEntities

private static void loadChunkEntities(Chunk chunk,
                                      NBTTagCompound nbt,
                                      World world)

captureConfig

static void captureConfig(java.io.File configDir)

syncConfigDefaults

public static void syncConfigDefaults()

Synchronizes the local fields with the values in the Configuration object.

getConfig

public static Configuration getConfig()

getDefaultsCategory

public static ConfigCategory getDefaultsCategory()

getModCategories

public static java.util.List<ConfigCategory> getModCategories()

getConfigFor

@Nullable
public static ConfigCategory getConfigFor(java.lang.Object mod)

addConfigProperty

public static void addConfigProperty(java.lang.Object mod,
                                     java.lang.String propertyName,
                                     java.lang.String value,
                                     Property.Type type)