autosave's Introduction

AutoSave

Automatically save, load, and sync NBT data with a easy to use, easy to extend, annotation based API.

How To Use

Label your fields

Simply annotate any fields that need to be saved with @Store.

public class MyObject {
    
    @Store
    private String name;
    
    @Store
    private int counter;
}

Serialize With Ease

The (de)serialization API is very simple, only a single line of code!

To write an object to NBT:

NBTTagCompound tag = new NBTTagCompound();
Writer.write(tag, object);

To read an object from NBT:

Reader.read(tag, object);

Automatic recursive serializer support

@Storable
public class StorableExample {
    
    @Store
    private String name;
}

public class Wrapper {
    
    @Store
    private StorableExample storable;
}

Writer.write(tag, new Wrapper()); // This will work!

Extend the supported field types

Registry registry = new Registry();
registry.register(new HandleMyObject());

...

class Wrapper {

    @Store
    private MyObject myObject = new MyObject();
}

NBTTagCompound tag = new NBTTagCompound();
Writer.write(registry, tag, new Wrapper());

Out-of-the-box Supported Types

Special Cases

Array types will automatically look for a handler for their component type
Supported generic types will do the same (List, Map, etc. See Java)

Java

All primitive types (including boxed types)
String
Enum
List (ArrayList)
LinkedList
Set (HashSet)
Map (HashMap)
EnumMap
Enum2EnumMap (Not a class, but a special case of EnumMap where the data is packed more efficiently)