Minecraft Script to Tellraw Datapack Generator

Overview

Minecraft Script to Tellraw Datapack Generator

by CCpcalvin

Note by CCpcalvin

Note that it is my first project and it is the final project of CS50 in edX. I know that the syntax is quite difficult and I try to make it as simple as possible. Also, the coding is not elegant as well. I may try to make it cleaner if I have time. Feel free to download it and even help me to improve the coding since I am still a beginner in coding.


Table of Contents

What is this generator do?

tellraw is the command in Minecraft to print the message in Minecraft. This command is essential especially for making map since it can be used to tell the player about the progress of the map, or the dialogue between NPC, or anything else. This generator can turn a script into multiple functions in a datapack of a Minecraft map so that we can execute multiple tellrawfunctions in one command.

Quickstart

To use this generator, we need to install python3. We first need to create script.txt file inside the folder containing multiple .py files. This file is used to input the script. Now we may write some lines inside the script.txt such as

Calvin: hello
Even: hello world
Calvin: hello Even

By running python tellraw.py, it will create two folders, namely start and scene_1 folders. Then you need to put those two folders inside the data folder of the datapack (by the way you can change the name of these two folders to prevent crashes of the name). Then in Minecraft, after reloading the datapack, by running /function start:scene_1, then those messages will pop up on the screen one by one with constant time intervals.

Advanced Usage

Principle of this generator

You may visit this wiki page for some basic information about datapack and this wiki for the basic information of function in datapack. A .mcfunction file contains a chain of command that can be executed inside Minecraft at the same time. This generator can generate multiple .mcfunction files with integer names inside the scene_1 folders (actually this generator can generate multiple scene folders. More detail can be found below). For a pure tellraw-purpose datapack, a .mcfunction may look like:

4s ">
tellraw @a {"text":"Ryan: Hello World"}
schedule function scene_1:
   
     4s

   

Here , are the placeholders. The first line of the code is the tellraw command that prints Ryan: Hello World and the second line of the code is to tell Minecraft to run next .mcfunction file in 4 seconds. Therefore by running the heading .mcfunction file, the tellraw command will be executed in every 4 seconds. The command /function start:scene_1 basically is to tell Minecraft to execute the heading .mcfunction file.

Inside script.txt

Beyond tellraw, we can add more stuff inside script.txt. The program will run each line into one .mcfunction file. The basic format of each line in script.txt is


   
     \ 
    
      \ 
     
       \ ... 

     
    
   

Here , , are the placeholders containing different actions to perform in one .mcfunction file. Each function has the format = , . is the placeholder of string to tell what command to be added inside a .mcfunction file. If we omit the = , then the program will automatically consider the string inside an argument is something to print out by tellraw. For example,

tell()=" Ryan: Hello World "

and

Ryan: Hello World

will generate the same .mcfunction file. Note that tell is the tag to indicate tellraw command.

There are many in this program. They will be discussed below.

Also, notice that a blank new line and \t in script.txt will be ignored in this program.

Behavior of delimiter

The program will use \ as the delimiter. You can change another symbol in symbol in the config file.

Changing input file

You can change the input file by running python tellraw.py . The third argument can be omitted and it will set script.txt as the input file.

List of functions available:

Beware that the space bar cannot be omitted. Only can be replaced. You can replace the empty string for .

Tellraw text:

We can use tell( )=" " or tellraw( )=" " or omit the tag to indicate that it is a tellraw command. Note that the space cannot be omitted. The advantage to use a tag instead of omitting it is we can change the font and the text color by some optional arguments. For example,

tell(c=Blue, b)=" Even " \ :Hello \ tell(i, u, c=#28D7CC, click(run=/weather clear))=" World "

to print:

There are lots of optional arguments in this function:

  1. Font related

    • c= or color= : to change the color. can be a word or a hex color code. Only word inside the list: [Red, Green, Blue, White, Yellow, Dark_Red, Dark_Green, Dark_Blue, and Gold] is accepted, and it is case-insensitive.
    • b or bold: to have bold text
    • i or italic: to have italic text
    • u or underlined: to have underlined text
    • s or strikethrough: to have strikethrough text
    • o or obfuscated: to have obfuscated text
  2. Event-related

    • click( = ) : to control what action to be performed when click the text. There are a few possible actions to be performed in this program
      • open: to open a url. should a url.
      • run: to run a command as the player who clicks the text. should be a command
      • suggest: to suggest a command to the player who click the text. should be a command
      • copy: to copy any string to the player's clipboard. can be any string.

Note that the program will read the line from left to right. Make sure to arrange the function in order. Also, you can print line-break with \n as the message.

Changing time interval

We use t= or time= to indicate how much time to wait to execute the next .mcfunction file. Without this tag, the function will automatically take 4 seconds to execute the next file. For example,

Even: Hello World \ t=2s
Calvin: Hello Even \ t=35t
Ryan: Hello everyone \ t=2d

We need to indicate the unit in time. There are three possible units: t, s, d. t stands for tick (roughly 20 ticks for 1 second. This can be changed by gamerule command), s stands for second and d stands for Minecraft-day (roughly 20 minutes).

Title

Sometimes you may want to use title instead of tellraw. We can use title( )=" "</code> to indicate the main title. If we want to add subtitle, we can use sub( )=" ") or subtitle( )=" " .

sub(c=black, o)=" The doom's day " \ title(in=20, out=20, dur=80, c=blue, b, u)=" Chapter 0 " \ t=5s

Both commands accepts the same font-related optional arguments as tellraw. Note that we must provide:

  • in=: to indicate the fade-in duration. The unit is tick and it must be an integer.
  • out=: to indicate the fade-out duration. The unit is tick and it must be an integer.
  • dur=: to indicate the duration of title that is visible and not in fade in time and fade out time. The unit is tick and it must be an integer.

Running another command

Sometimes you may want to execute some commands other than tellraw or title command, in that case, we can use run=. For example,

Even: Give you some healing \ t=3s
Calvin: Thanks you \ run=effect give @a minecraft:regeneration 5 1 true

Then at the same time that print "Calvin: Thanks you", it also gives the regeneration to all the players.

Comment

Sometimes you may want to comment on some commands. The way to do it is to use -- -- . The program will ignore the whole sequence. It can also be used to a new line.

-- Even appear and talk to Ryan --
Even: Hello Ryan \ t=2s \-- Even should face to Ryan --\
Ryan: Hello Even\ t=3s 

Ending the dialogue

Sometimes you may want to end the dialogue(more precisely ending the chain of command). You can use end tag. For example:

Even: Hello Calvin \ end 
Calvin: Hello Even

Although the program will also produce 2.mcfunction that contain a tellraw command, "Calvin: Hello Even" will not print out because of the end tag in the first line.

Writing command in multiple lines

Sometimes you want to add lots of things in one .mcfunction. To have a good and clean style, we can use cont or tag at the end of the line to indicate that functions in the next line should also be written in the same .mcfunction as the pervious line. For example:

-- Boss fight start --
tell(c=red)=" Boss "\ :Let's get started!! \ cont 
	run=function trackboss:start \-- Start tracking boss health --\ cont 
	run=function bossbar:on \-- Enable bossbar and write the boss' health to bossbar --\ cont 
	run=function boss_fight_bgm:start \-- Start bgm --\ end 

will give out a .mcfunction file that contains:

tellraw @a ["", {"text": "boss", "color": "red"}, ":Let's get started!!"] 
function trackboss:start
function bossbar:on
function boss_fight_bgm:start

Creating a new folder

For a long script, you may not want to put all .mcfunction in the same folder. We can use create= to tell the program to create a new folder and put the remaining .mcfunction to the new folder. Make sure that you do not have the folder with the same name, otherwise, the program will replace the origin folder to new folder or exit depend on the value of REPLACE. Note that is case-insensitive and the program will turn all characters to lowercase since namespaces in Minecraft do not allow any uppercase letter.

create=scene_1 \ cont 
-- Even appear and talk to Ryan --
Even: Hello Ryan \ t=2s \-- Even should face to Ryan --\
Ryan: Hello Even\ end 

create=scene_2 \ cont
-- Boss fight start --
tell(c=red)=" Ryan " \ :Let's get started!! \ cont 
	run=function trackboss:start \-- Start tracking boss health --\ cont 
	run=function bossbar:on \-- Enable bossbar and write the boss' health to bossbar --\ cont 
	run=function boss_fight_bgm:start \-- Start bgm --\ end 

This tag also add a function in start folder so that by running \function start:scene_2 to execute the heading of scene 2.

Config File Settings

We can change the behaviour of the program in config.txt file.

Changing the delimiter

Write DELIMITER=" " to change the delimiter

Automating apply the style to text

You may want to automatically apply the particular text style for particular word. To do this, we write:

" ">
tell(
     
      )=" 
      
        "

      
     

in config.txt file. The is the same as the optional argument in tell tag. For example:

tell(c=red, b)=" Ryan " 
tell(c=green, u)=" Even "

In this case, the program will turn all "Ryan" to red bold text and all "Even" to green underlined text.

Replacing existed file

By default, the program will exit when there is a crash of the folder name. By writing REPLACE = "yes" in config.txt, it will replace the existed file instead of exiting.

You might also like...
Setup minecraft server (Tuinity) to your directory
Setup minecraft server (Tuinity) to your directory

hapeshiva server-setup Setup minecraft server (Tuinity) for you. Support for optimization Create optimized yml Customazible server port and view dista

Automatically prepare your Minecraft maps for release

map-prepare Automatically prepare Mineraft map for release. Current state: kinda works Make sure you have backups for your world before running this p

PyCraft - A Minecraft launcher made in python

A Minecraft launcher made in python. The main objective of this launcher is to enable players to enjoy minecraft (especially those without a mojang/microsoft account). This launcher is not illegal as all files are downloaded from libraries.minecraft.net

 A Minecraft clone written in python and pyglet.
A Minecraft clone written in python and pyglet.

PyCraft A Minecraft clone written in python and pyglet. Running PyCraft To run PyCraft, run the following code: git clone https://github.com/TheWebCra

A project to san the internet of all open Minecraft servers.

MC-Server-Finder A project that scans the internet to find open Minecraft servers. Install the dependencies by running pip install -r requirements.txt

My first Minecraft CPU. Created in collaboration with Peer Carnes as a final project in CS 281: Architecture and Assembly at the University of Puget Sound
My first Minecraft CPU. Created in collaboration with Peer Carnes as a final project in CS 281: Architecture and Assembly at the University of Puget Sound

Minecraft CPU This is my first ever Minecraft CPU, created in collaboration with Peer Carnes. We created a custom assembly language, including an asse

Utility for generating randomizer datapacks for minecraft.

Minecraft Rando Utility for generating randomizer datapacks for minecraft. At the moment, it randomizes the following: Loot tables (including block dr

Deliver buycraft orders to players across the map in minecraft servers using baritone

Deliver buycraft orders to players across the map in minecraft servers using baritone

You want to uto-update your private minecraft client? Give this to developer and enjoy!

minecraft-hack-installer You want to uto-update your private minecraft client? Give this to developer and enjoy! Steps to do: Install libraries: pip i

Owner
null
Dontdie-minecraft - A python program that causes your computer to bluescreen whenever you die in Minecraft

Don't Die - A Python Program A python program that causes your computer to blues

null 3 Apr 19, 2022
Minecraft.nix - Command line Minecraft launcher managed by nix

minecraft.nix Inspired by this thread, this flake contains derivations of both v

null 12 Sep 6, 2022
Minecraft - Online Players Overlay Generator

Minecraft - Online Players Overlay Generator Contents About Quick Start Download Pre-Built Binary Run from Source Configuration Command-Line Options F

null 4 Sep 12, 2022
A simple script which allows you to see how much GEXP you earned for playing in the last Minecraft Hypixel server session

Project Landscape A simple script which allows you to see how much GEXP you earned for playing in the Minecraft Server Hypixel Usage Install python 3.

Vincenzo Deluca 4 Dec 18, 2021
Script to remap minecraft 1.12 java classes.

Remapper Script to remap minecraft 1.12 java classes. Usage You must have Python installed. You must have the script, mappings, and files / folders in

null 8 Dec 2, 2022
A simple python script to pregenerate minecraft worlds.

mcloady mcloady is a lightweight python script used to pre-generate Minecraft terrain using MCRcon and carpet mod (optional). Inspired by Pre-Generati

null 5 Dec 8, 2021
python script to convert .OBJ files into Minecraft, rendering them in game with a core shader.

samples: random notes about the tool general output format: (animation not supported yet but planned) vertex id Minecraft's gl_VertexID isn't per mode

null 199 Jan 2, 2023
Minecraft clone using Python Ursina game engine!

Minecraft clone using Python Ursina game engine!

Taehee Lee 35 Jan 3, 2023
Open-source project written in the ursina engine, simulating the popular game Minecraft.

Voxelcraft is an open-source project written in the ursina engine, simulating the popular game Minecraft.

Calinescu Mihai 21 Oct 6, 2022
Creates a landscape with more accurate river generation in Minecraft version 1.12 using python.

MinecraftLandRiverGen View the following youtube video to set up a world that can interact with the python programs

null 23 Dec 25, 2022