# SpeechTools<\/p>\n
## Create smooth, custom speech with just one command!<\/p>\n
### Features Include:
\n – Full control over typing speed, transformation, shake, and much more<\/p>\n
– Events system allowing you to run commands and change arguments at any point<\/p>\n
All it takes is one command!<\/p>\n
# How to use SpeechTools
\n_This page is viewable in game by using the command `\/function speechtools:help`_<\/p>\n
### To create a speech entity, use the command: `\/function speechtools:create {args:{},events:[]}`<\/p>\n
## ARGUMENTS<\/p>\n
– **`text:`** *Raw string, no json elements. e.g: `args:{text:”Hi there!”}`*
\n*To use quotation marks or apostrophes, you have to type `\\”` or `\\’`
\n(for versions 1.1.1 and below: apostrophe:`\\’` quotation marks:`\\’\\’`)*
\n– **`extra:`** *Any json elements to be attached to the text (color, font, bold etc). e.g: `args:{extra:’ “bold”:true,”color”:”green” ‘}`*
\n– **`duration:`** *Integer duration of the speech before disappearing. Default: 100*
\n– **`wait:`** *Integer duration of ticks before the speech starts, or as a pause in events. Used for instances with multiple speech entities which start at different times. Default: 0*
\n– **`fade_in:`** *Duration of how long the text scales up from 0 when spawned. Set to 0 for no interpolation. Default: 3*
\n– **`fade_out:`** *Duration of how long the text scales down to 0 when ending. Set to 0 for no interpolation. Default: 3*
\n– **`typed:`** *true | false || Text is typed out over time instead of instantly appearing. Default: true*
\n– **`typed_delay:`** *Delay between typed letters, in ticks. Default: 2*
\n– **`punctuation_delay:`** *Additional tick delay when punctuation is typed (.!?:;,) Commas use half this delay. Defaults to `typed_delay` value.*
\n– **`shake:`** *Text shaking effect, higher number, more shake. Experiment with `teleport_duration` to adjust effect. Max of 50. Default: 0*
\n– **`teleport_offset:`** *String set of coordinates to teleport to. Used with `teleport_duration` to create a sliding effect. e.g. `args:{teleport_offset:”~ ~2 ~”}`*
\n– **`transformation:`** *Same format as a display entities transformation.*
\n– **`Other NBT`** *You can also put any other text_display nbt in `args{}`, e.g. `billboard:`, `background:`, `text_opacity:` etc.*<\/p>\n
## EVENTS
\n#### To add events to your speech entity, you can use the events[] field like so: `function speechtools:create {args:{},events:[ {on:40,command:”say test”} ]}`<\/p>\n
### **`on:`** *Required for every event, specified with the following:* – **`command:`** *String. Runs a command of the players choosing from the speech entity. e.g. `{on:100,command:”function your:function\/here”}`* ## Using Multiple Events # Limitations Any feedback\/tips are appreciated!<\/p>\n","protected":false},"excerpt":{"rendered":" [Java 1.21.5+] Create smooth custom speech with just one command!<\/p>\n","protected":false},"featured_media":146604,"template":"","meta":{"_minecraft_slug":"speechtools","_minecraft_project_id":"Z4WRz1PN","_minecraft_author":"dont-give-adam","_minecraft_license":"CC0-1.0","_minecraft_downloads":38,"_minecraft_follows":2,"_minecraft_client_side":"optional","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"speechtools.zip","_minecraft_size_bytes":23672,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T23:40:31.786421Z","_minecraft_date_created":"2025-03-28T04:54:46.581532Z","_minecraft_date_modified":"2025-03-27T23:12:16.781434Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/speechtools","_minecraft_icon_attachment_id":146604,"_minecraft_imported_at":"2026-06-08T18:52:43+00:00","_minecraft_import_hash":"8d1b536a22fea3ac3a400c24b6d9e057","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[84,92],"mod_loader":[86],"minecraft_version":[37,73,74,38,78,79,80],"class_list":["post-146603","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-datapack","mod_category-utility","mod_loader-datapack","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7"],"yoast_head":"\n
\n– **`on:
\n– **`on:start`** *Executes the event when the entity spawns.*
\n– **`on:end`** *Executes the event when the entity’s duration expires.*
\n– **`on:type`** *(when typed:true) Executes the event for every character typed, ignoring spaces. Intended for Undertale\/Animal Crossing style voices.*
\n– **`on:tick`** *Executes the event every tick.*
\n<\/p>\n
\n– **`modify_args:`** *Same format as the ‘args’ field, can be used to change transformation, change typing speed, etc. e.g. `{on:150,modify_args:{typed_delay:10}}`*
\n– **`pause_on_tick:`** *Integer. If an `on:tick` event is set, pause it for this many ticks.*<\/p>\n
\nSimply add to the events array like so: `[{on:start,command:”say hi”},{on:25,modify_args: {shake:10}},{on:50,modify_args:{shake:0}}]`
\n
\nIf you want to add multiple events to one `on:` condition, do this: `[{on:25,command:”say hi”,pause_on_tick:5,modify_args: {typed_delay:10}}]`<\/p>\n
\n– As of right now, you can only have single element text, meaning you can’t have one section of text in *`italic:true`* and the rest in *`italic:false`* . Instead you have to use multiple speech entities to achieve this effect.
\n– If `fade_in:` is activated, the transformation will take place on tick 3 of the entity, due to inconsistencies when ran on earlier ticks.<\/p>\n