@meza - http://twitch.tv/vsbmeza3 - http://twitter.com/vsbmeza3

The Achievement Books mod introduces the ability to create * multiple * achievement books for Minecraft.

It is highly configurable via JSON to have headers, free flow text and achievement checklists on multiple pages.

• you can have multiple achievement books for different parts of your game
• you don't need to deal with difficult formatting files
• you can describe your books in an easy-to-read format
• you can add/remove/edit entries without players losing their achievement progress
• you can reload the books from the config without restarting the game (not since 1.18.1)

Make sure you're using Fabric

To install the mod, head over to the project's page on CurseForge https://minecraft.curseforge.com/projects/achievement-books and download it into your minecraft installation's mods folder.

Note, that this is the same process for servers or clients.

If your minecraft game is running, you need to restart it for the mod to be loaded into the game.

As the mod starts the first time, you will have an example config created for you.

You can access the achievement book by:

/ab give

This will give you a mini achievement list on how to get to know the mod better.

This book is configured at config/achievementbooks/demo.json I recommend you go through the book in the game and do all the exercises there to fully understand what the mod is or is not.

The mod listens to

/ab <command>

/ab give

Gives the player every book registered in the system

/ab list

Lists all registered books and their IDs

/ab init

Re-creates the demo.json file in the config folder if you ever need to reset it.

All books are configured in an easy to read JSON file. The contents of the file represent a JSON Object, so it must start with a { and must and with a }.

Like this:

{}

The most minimal valid book is as follows:

{
	"itemName": "book_smallest",
	"bookName": "The smallest book",
	"pages": []
}

This identifies the book in the item registry of the game. This needs to be unique for every book you create. In the game, you'll be able to use: /give @p achievementbooks:book_smallest if you wish Since it's used to identify books in sava data too, if you change this after you've started using the mod, you may lose your progress.

A book's name is the most important feature of the book. This is how it shows up in the game, and this is how it's identified. Unfortunately this means that the only thing that cannot be edited easily after the fact, is the book name. So choose carefully.

Every book in the Achievement Books mod can be configure to be craftable or not. If you specify a crafting material in a mod:item format, then the book will be craftable with that material and a book. For example if you specify: minecraft:cobblestone as the crafting material, then if you put a regular book and a cobblestone in a crafting grid next to eachother, it will create your book.

There are currently 16 colours you can use for your book. These are:

Colour parameter	Book icon
aqua
black
blue
brown
deepblue
gray
green
lime
olive
orange
orangered
peach
pink
purple
red
yellow

 {
 	"itemName": "coloured_book_smallest",
 	"color": "orange",
 	"bookName": "The smallest book",
 	"pages": []
 }

The second most important part of the book is the list of pages it has. This is an array of arrays of page items, which means that the general format is:

{
	"itemName": "book_example",
	"bookName": "Page example book",
	"pages": [
		[],
		[],
		[]
	]
}

This adds 3 empty pages to the book. You can populate each page with a list of page items. Their configuration is as follows:

Page items are JSON Objects again, which means they all need to be surrounded by { and }. There are currently 3 types of elements that you can define:

A header item that can be used to add som context for the user. Maybe a story line, or some explanation on why they should complete the achievements.

{
	"id": 1,
	"header": "Welcome to the book of achievements",
	"description": "This is a subsection for the header and completely optional"
}

The id is required to be a unique number for every page item, as this identifies them later. The order is not important, they just have to be unique.

The text that you would like to see as bold, and centered on the page

A text that is italic, aligned left and fits right under the header

You can of course add non-fancy text anywhere

{
	"id": 2,
	"description": "Another element, this time only with text"
}

The id is required to be a unique number for every page item, as this identifies them later. The order is not important, they just have to be unique.

A text that is italic, aligned left

Adding achievements is no different

{
	"id": 3,
	"achievement": "Carefully read the documentation",
	"mod": "Achievement Books"
}

The id is required to be a unique number for every page item, as this identifies them later. The order is not important, they just have to be unique.

The achievement text. Keep it short and concise if you want to make it look good. #protip

An extra information for the player, if the achievement is targeting a specific mod. This shows up in brackets and in blue

{
	"itemName": "book_example",
	"bookName": "Achievement Book Demo",
	"color": "black",
	"craftingMaterial": "minecraft:cobblestone",
	"pages": [
		[
			{
				"id": 1,
				"header": "Welcome to the Achievement Book Demo2",
				"description": "This book is only here to show you the capabilities of this mod\n"
			},
			{
				"id": 2,
				"description": "You can define a texts, headers and achievements in the config/achievementbooks folder"
			}
		],
		[
			{
				"id": 3,
				"header": "Getting to know the config"
			},
			{
				"id": 5,
				"achievement": "Craft the Achievement Book Demo book",
				"mod": "vanilla"
			},
			{
				"id": 4,
				"achievement": "Check out the demo config file for the Achievement Books Mod",
				"mod": "Achievement Books"
			},
			{
				"id": 6,
				"achievement": "Add a new achievement to the Achievement Book Demo",
				"mod": "Achievement Books"
			}
		],
		[
			{
				"id": 7,
				"header": "Advanced Topics"
			},
			{
				"id": 8,
				"achievement": "Create another achievement book next to the Achievement Book Demo",
				"mod": "Achievement Books"
			},
			{
				"id": 9,
				"achievement": "Change the wording of achievement id 4 in the Achievement Book Demo",
				"mod": "Achievement Books"
			},
			{
				"id": 10,
				"achievement": "Reorder the achievements on page 2 of the Achievement Book Demo",
				"mod": "Achievement Books"
			}
		]
	]
}