[\u4e2d\u6587](\/readme\/zh_cn.md)<\/p>\n
# Introduction<\/p>\n
D’s Better Schedule is a library that provides a scheduler that keeps the context.
\nIt will record the executor, location, rotation, and in some cases, dimension(see below) of the current context.
\nIt also focuses on the behavior when the executor entity is offline, dead, or unloaded at the time of execution.<\/p>\n
## How to Use<\/p>\n
**To use the scheduler, first put the required data in storage `dah.sch:new new`.** Fields:<\/p>\n
`run`: `#[command] string` The command to run as a string. No slash. ***REQUIRED***<\/p>\n
`time`: `int` The number of ticks to wait before running the command. ***REQUIRED***<\/p>\n
`offline`: `string`
\nWhat to do if the target entity is not found at the time of execution (offline, dead, or unloaded). Defaults to `discard`:
\n * `discard`: Do nothing and remove the task.
\n * `delay`: **PLAYER ONLY** The timer ticks when the player is offline, but only executes until the player go back online
\n * `pause`: **PLAYER ONLY** Timer freezes when the player is offline.
\n * `by_server`: The command will be executed by the server instead.<\/p>\n
`max_retry`: `int` If `offline` is set to `discard` or `by_server`, then if entity is not found at execution time, the task will be re-attempted on the next tick, up to `max_retry` number of times. If all retries failed then it proceeds to be discarded or executed by server accroding to `offline`. Defaults to `0`.<\/p>\n
`flags`: `[string]` Defines extra behaviors for the task. May includes:<\/p>\n
* `no_executer`: The executor will not be included in the context; the command will be run by server.
\n * `location_less`: The Location and Rotation will not be included in the context; command will be run at world spawn
\n * `debug`: Output debug information to chat.
\n * `try_dimension`: It will try to find the current dimension. The library will read it from entity data if the executor is a player, or it trys if it is `overworld`, `the_nether` or `the_end`. Otherwise it assumes `overworld`. You may add other custom dimensions into the function tag `#dah.sch:known_dimensions`, running `execute at @s if predicate {condition:”location_check”,predicate:{dimension:”foo:bar”}} run data modify storage dah.sch:task this.in set value “foo:bar”` to extend the trial and error list.<\/p>\n
`in`: `#[id=”dimension”] string` Specifies a dimension to run the command in. This will be overwritten by the `try_dimension` flag.<\/p>\n
**Then execute `function dah.sch:new` in the desired context to schdule the command.**<\/p>\n
Example:
\n“`mcfunction
\n# teleport the executor back to the current loction after 1s.
\ndata modify storage dah.sch:new new set value {run:”tp ~ ~ ~”,time:20}
\nfunction dah.sch:new<\/p>\n
# setblock stone at current location after 1s, try to find the current dimension and spit out debug info.
\ndata modify storage dah.sch:new new set value {run:”setblock ~ ~ ~ stone”,time:20,flags:[“debug”,”try_dimension”]}
\nfunction dah.sch:new<\/p>\n
# Remove this player’s attribute modifier after 10s. If the player goes offline in 10s then remove it after they log back in.
\ndata modify storage dah.sch:new new set value {run:”attribute @s attack_damage modifier remove foo:bar”,time:200,offline:”delay”}
\nfunction dah.sch:new
\n“`<\/p>\n
A simple macro version of the schduler is also provided as `function dah.sch:set`. It can only take in the `time` and `run` parameter:
\n“`mcfunction
\nfunction dah.sch:set {run:’say 1′, time: 20}
\n“`<\/p>\n
## Dependency File<\/p>\n
A `DBS-Dependency.zip` is included in the release. Put this file anywhere on your computer, then by creating a `spyglass.json` file at the root of your workspace, the Spyglass extension will provides you the completion and error checking of all the functions, storages, and tags you need to write to use this library.<\/p>\n
Example content of the `spyglass.json` file. See Spyglass Documentation for more.
\n“`json
\n{
\n\t“env”: {
\n\t\t“dependencies”: [
\n\t\t\t“file:\/\/\/C:\/path\/to\/DBS-Dependency.zip”,
\n\t\t\t“@vanilla-mcdoc”,
\n\t\t\t“@vanilla-resourcepack”,
\n\t\t\t“@vanilla-mcdoc”
\n\t\t],
\n\t\t“gameVersion”: “1.21.5”
\n\t}
\n}
\n“`
\nRemeber to Reload Vscode. If something about this somehow goes wrong, make Vs Code run the `Spyglass: Reset Project Cahce` command.<\/p>\n
## Compatibility<\/p>\n
This library, by itself, overrides no vanilla namespaces, does not modify\/create\/remove any world elements (blocks, entities, etc.), and all ids have the `dah.sch` prefix or namespace. Yes, this makes it follows the Smithed and essential MC Datapacks Discord Server Conventions. There should be zero worries about its compatibility.<\/p>\n
## Uninstall<\/p>\n
Because of how this library is implemented, it is not possible to unload the datapack data while it is enabled.<\/p>\n
Thus, first remove the datapack, reload, then you may execute the commands listed in the `unload.mcfunction` file provided in the root folder to delete the remaining data. Follow the instructions in that file.<\/p>\n
## Links<\/p>\n
A gu library is included to convert UUIDs<\/p>\n
Repository: https:\/\/github.com\/Dahesor\/D-Better-Schedule<\/p>\n
Modrinth: https:\/\/modrinth.com\/project\/d-better-schedule<\/p>\n","protected":false},"excerpt":{"rendered":"
A data pack library that provides a scheduler that keeps the context.<\/p>\n","protected":false},"featured_media":53567,"template":"","meta":{"_minecraft_slug":"d-better-schedule","_minecraft_project_id":"2WdgXp6p","_minecraft_author":"Dahesor","_minecraft_license":"MIT","_minecraft_downloads":46,"_minecraft_follows":1,"_minecraft_client_side":"optional","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"d-better-schedule.zip","_minecraft_size_bytes":51865,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T23:27:42.251386Z","_minecraft_date_created":"2025-05-08T00:37:58.763200Z","_minecraft_date_modified":"2026-02-04T02:52:47.148451Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/d-better-schedule","_minecraft_icon_attachment_id":53567,"_minecraft_imported_at":"2026-06-03T00:01:50+00:00","_minecraft_import_hash":"06b48fefadf122a2aa245a584200c4bc","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[84,873],"mod_loader":[86],"minecraft_version":[62,37,40,41,808,809,810,811,812,73,71,72,74,38,78,79,80,81,82,63,64,65,66,67,68,69,70,75,76,77,816,817,818,819,820,821],"class_list":["post-53566","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-datapack","mod_category-library","mod_loader-datapack","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-11-pre1","minecraft_version-1-21-11-pre2","minecraft_version-1-21-11-pre3","minecraft_version-1-21-11-pre4","minecraft_version-1-21-11-pre5","minecraft_version-1-21-2","minecraft_version-1-21-2-pre1","minecraft_version-1-21-2-pre2","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","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-24w33a","minecraft_version-24w34a","minecraft_version-24w35a","minecraft_version-24w36a","minecraft_version-24w37a","minecraft_version-24w38a","minecraft_version-24w39a","minecraft_version-24w40a","minecraft_version-24w44a","minecraft_version-24w45a","minecraft_version-24w46a","minecraft_version-26-1-snapshot-1","minecraft_version-26-1-snapshot-2","minecraft_version-26-1-snapshot-3","minecraft_version-26-1-snapshot-4","minecraft_version-26-1-snapshot-5","minecraft_version-26-1-snapshot-6"],"yoast_head":"\n