Saved Data - Revision history

ChampionAsh5357: Update to 1.17

2021-08-02T21:01:06Z

Update to 1.17

ChampionAsh5357: ChampionAsh5357 moved page World Saved Data to Saved Data: Class rename

2021-08-02T19:43:29Z

ChampionAsh5357 moved page Saved Data to Saved Data: Class rename

ShrimpBot: Categorize with Category:Data Storage by SizableShrimp#0755

2021-05-19T00:59:44Z

Categorize with Category:Data Storage by SizableShrimp#0755

ChampionAsh5357: Basic WSD Explanation

2020-12-20T06:45:53Z

Basic WSD Explanation

New page

World Saved Data is an alternative to capabilities that stores data per dimension or globally depending on how the context is passed.

==Class Structure==

The class can be broken down into three important methods:
- <code>read</code>: Read the stored nbt data.
- <code>write</code>: Write the object to nbt.
- <code>markDirty</code>: Tell the object to save the data to file.

The <code>read</code> and <code>write</code> methods need to be implemented while <code>markDirty</code> should be called whenever the data is going to be manipulated. As the class is abstract, it should be subclassed with these three methods implemented.

The super call requires a <code>String</code> argument. This is used to denote the name of the data file within the dimension itself. For example, if the argument was "pipes", then a file would be created within each dimension folder called <code>data/pipes.dat</code>.

==Attaching to a Dimension==

To attach a World Saved Data to a particular dimension, you must have access to an instance of <code>ServerWorld</code> or <code>ServerChunkProvider</code>. From there, you can call the method <code>#getSavedData</code> which will give you an instance of the <code>DimensionSavedDataManager</code>: the class that stores all saved data for that particular dimension. You can attach an instance or get the current instance of the data using <code>DimensionSavedDataManager#getOrCreate</code>. This should be used in most cases to get an instance of the specified data or create a new one if not available. From there, you can operate on your saved data as if it was a capability.

Global attachments are the same by either synchronizing the data between the three worlds or using the same object reference stored in each world.

@@ Line 1: / Line 1: @@
-World Saved Data is an alternative to capabilities that stores data per dimension or globally depending on how the context is passed.
+<code>SavedData</code> is an alternative to capabilities that stores data per dimension or globally depending on how the context is passed.
 ==Class Structure==
-The class can be broken down into three important methods:
+The class can be broken down into two important methods:
-  - <code>read</code>: Read the stored nbt data.
+  - <code>save</code>: Write the data to nbt.
- - <code>write</code>: Write the object to nbt.
+  - <code>setDirty</code>: Tell the game that the data has changed and needs to be saved to file.
-The <code>read</code> and <code>write</code> methods need to be implemented while <code>markDirty</code> should be called whenever the data is going to be manipulated. As the class is abstract, it should be subclassed with these three methods implemented.
+The <code>save</code> method need to be implemented while <code>setDirty</code> should be called whenever the data is going to be manipulated. As the class is abstract, it should be subclassed with these three methods implemented.
-The super call requires a <code>String</code> argument. This is used to denote the name of the data file within the dimension itself. For example, if the argument was "pipes", then a file would be created within each dimension folder called <code>data/pipes.dat</code>.
+==Attaching to a Level ==
-==Attaching to a Dimension==
+To attach a Saved Data to a particular level, you must have access to an instance of <code>ServerLevel</code> or <code>ServerChunkCache</code>. From there, you can call the method <code>#getSavedData</code> which will give you an instance of the <code>DimensionDataStorage</code>: the class that stores all saved data for that particular dimension. You can attach an instance or get the current instance of the data using <code>DimensionDataStorage#computeIfAbsent</code>. This takes in three arguments: the first to construct a saved data with data already existing in some <code>CompoundTag</code>, the second to construct a saved data with no existing data, and the third to specify the name of the file to save the data to within the <code>data</code> folder in the overworld or in the specific dimension of the save.
-To attach a World Saved Data to a particular dimension, you must have access to an instance of <code>ServerWorld</code> or <code>ServerChunkProvider</code>. From there, you can call the method <code>#getSavedData</code> which will give you an instance of the <code>DimensionSavedDataManager</code>: the class that stores all saved data for that particular dimension. You can attach an instance or get the current instance of the data using <code>DimensionSavedDataManager#getOrCreate</code>. This should be used in most cases to get an instance of the specified data or create a new one if not available. From there, you can operate on your saved data as if it was a capability.
+Global attachments are the same except that they should only be attached to the overworld as that level will always persist.
 [[Category:Data Storage]]

← Older revision		Revision as of 00:59, 19 May 2021
Line 17:		Line 17:

	Global attachments are the same by either synchronizing the data between the three worlds or using the same object reference stored in each world.		Global attachments are the same by either synchronizing the data between the three worlds or using the same object reference stored in each world.
		+
		+
		+	[[Category:Data Storage]]

← Older revision	Revision as of 19:43, 2 August 2021
(No difference)