RTFM! Seriously, I worked hard on it

This commit is contained in:
Andrew-71 2023-08-04 14:07:58 +03:00
parent 8684798259
commit 78a5cb111b
32 changed files with 566 additions and 73 deletions

BIN
docs/assets/img/banner.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 465 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 421 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 361 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 52 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 46 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 52 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.9 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 44 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 44 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 50 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 44 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 13 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 13 KiB

BIN
docs/assets/img/icon.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 58 KiB

36
docs/assets/style.css Normal file
View file

@ -0,0 +1,36 @@
@font-face {
font-family: 'ComputerCraft';
src: url('fonts/ComputerCraft.woff2') format('woff2'),
url('fonts/ComputerCraft.woff') format('woff');
font-weight: 500;
font-style: normal;
font-display: swap;
}
code {
font-family: ComputerCraft, monospace;
}
.wy-side-nav-search {
background-color: #d2651d;
}
.wy-side-nav-search input[type="text"] {
border-color: #d96b25;
}
.wy-menu-vertical header, .wy-menu-vertical p.caption {
color: #e78e53;
}
.section > h1 > img {
max-width: 15%;
}
.rst-content img {
image-rendering: pixelated;
image-rendering: -moz-crisp-edges;
image-rendering: crisp-edges;
width: 50px;
}

View file

@ -0,0 +1,7 @@
# ![Block model](../assets/img/blocks/food_machine.png) Food Machine
This block lets you exchange some of your TARDIM's fuel for food.
I plan to make it work with datapacks and let you switch between different types of food at different prices.
However, right now it is creative mode only and dispenses bread. If you want, you can add crafting recipe for it on your own,
but it is not recommended since I haven't finished it yet

View file

@ -0,0 +1,5 @@
# ![Block model](../assets/img/blocks/redstone_tardim_input.png) Redstone TARDIM Input
This block acts same as other TARDIM control panels, but is activated when redstone signal is passed to it.
## Crafting
![Crafting recipe](../assets/img/crafting/redstone_input.png)

22
docs/commands.md Normal file
View file

@ -0,0 +1,22 @@
# New TARDIM commands
## Cloister bell
Usage - `/cloister-bell`
Makes a loud cloister bell sound from the TV show, to signal warning or other notifications. Usage with redstone input recommended
---
## List biomes
Usage - `/list-biomes <..search_query>`
Lists all existing biomes for better experience with `/locate-biome` and parity with CC integration.
Can be used with no parameters to get all biomes or with a search string to only show biomes that contain it in their name
---
## List dimensions
Usage - `/list-dimensions`
Lists all existing dimensions for better experience with travel and parity with CC integration.

View file

@ -1,15 +1,20 @@
# ComputerCraft compatibility
If you have ComputerCraft: Tweaked installed,
TARDIM: IC provides quite a few peripherals.
The main one is new Digital TARDIM Interface,
which gives you complete control over your TARDIM.
However, some TARDIM blocks also receive getters for information related to them.
## ComputerCraft for beginners
ComputerCraft adds working computers to minecraft, controlled by Lua language.
If you are new, [CC's official discord](https://discord.com/servers/minecraft-computer-mods-477910221872824320) has a lot of people who can help.\
I also suggest taking a look at [Lua's website](https://www.lua.org/start.html) and [CC: Tweaked's documentaion](https://tweaked.cc)\
Please do not ask questions about CC itself in TARDIM: IC's Discord.
If you are new, [CC's official discord](https://discord.com/servers/minecraft-computer-mods-477910221872824320) has a lot of people who can help.
I also suggest taking a look at [Lua's website](https://www.lua.org/start.html) and [CC: Tweaked's documentaion](https://tweaked.cc)
Please do not ask questions about ComputerCraft itself in TARDIM: IC's Discord. I am far from the most experienced user of that mod.
## Notes about mod's peripherals
All of the peripherals throw if they are called outside a TARDIM. Only digital interface has ability to **set** data, others can only **get**.
## Available peripherals
| Type | Description |

View file

@ -1,4 +1,299 @@
# Digital TARDIM Interface
This peripheral allows you to do basically anything any other TARDI< control panel can, but automatically.
# ![Peripheral model](../../assets/img/blocks/digital_tardim_interface.png) Digital TARDIM Interface
This peripheral allows you to do basically anything any other TARDIM control panel can, but automatically.
### Methods
Attach name - `"digital_tardim_interface"`
## Crafting
![Crafting recipe](../../assets/img/crafting/digital_interface.png)
## Methods
### `getFuel()`
Get how much fuel the TARDIM has.
**Returns**
1. `number` The amount of fuel, from 0 to 100. Not rounded.
---
### `calculateFuelForJourney()`
Get how much fuel the TARDIM would use if you travelled to destination.
**Returns**
1. `number` The amount of fuel
---
### `isLocked()`
Check whether the TARDIM's doors are locked
**Returns**
1. `bool` Whether the doors are locked
---
### `setLocked(locked)`
Sets the TARDIM's lock
**Parameters**
1. locked `bool`: true to lock doors, false to unlock
---
### `isInFlight()`
Check whether the TARDIM is in flight
**Returns**
1. `bool` Whether the TARDIM is in flight
---
### `getTimeEnteredFlight()`
Get UNIX timestamp of when the TARDIM entered flight
**Returns**
1. `number` Unix timestamp or -1 if TARDIM is landed
---
### `getOwnerName()`
Will write the given input to the linked display.
**Returns**
1. `string` The username of TARDIM's owner
---
### `getCurrentLocation()`
Retrieve the TARDIM's current location
**Returns**
1. `table` The location of the tardim:
```
{
dimension = "minecraft:overworld", -- Dimension string
pos = { -- Coordinates
x = 1,
y = 2,
z = 3
}
}
```
---
### `getTravelLocation()`
The same as `getCurrentLocation()` but for destination
---
### `getCompanions()`
Get all list of all companions in the TARDIM
**Returns**
1. `table` list of companions' names
---
### `setDimension(dimension)`
Set TARDIM's destination to a dimension
**Parameters**
1. dimension `string`: dimension's name e.g. "minecraft:overworld"
---
### `setTravelLocation(x, y, z)`
Set TARDIM's destination coordinates
**Parameters**
1. x `number`: x-axis of destination
2. y `number`: y-axis of destination
3. z `number`: z-axis of destination
---
### `home()`
Set TARDIM's destination to roughly owner's respawn point
---
### `locatePlayer(username)`
Set TARDIM's destination to a player's coordinates
**Parameters**
1. username `string`: player's username. the player must be online.
---
### `getOnlinePlayers()`
Get all list of all online players
**Returns**
1. `table` list of players' names
---
### `getDoorRotation()`
Get current door rotation
**Returns**
1. `string` direction - "north"/"west"/"south"/"east"
---
### `setDoorRotation(rotation)`
Get current door rotation
**Parameters**
1. rotation `string` direction string - "north"/"west"/"south"/"east"
---
### `toggleDoorRotation()`
Toggle door rotation north -> east -> south -> west -> north
---
### `coordAdd(axis, amount)`
Add a number to the destination's coordinates
**Parameters**
1. axis `string` x/y/z
2. amount `number` how much to add/substract
---
### `demat()`
Dematerialise the TARDIM. Throws if TARDIM is in flight already.
---
### `remat()`
Re-materialise the TARDIM at the destination.
**Throws if**
1. TARDIM landing is obstructed
2. Not enough fuel for journey
3. TARDIM is still taking off
4. TARDIM has already landed
---
### `locateBiome(biome)`
Set destination to somewhere in a specific biome.
**Parameters**
1. biome `string` biome name e.g. minecraft:badlands or terralith:skylands_spring
**Throws if**
1. Biome has not been founded near
2. Biome name is wrong
---
### `setSkin(skin)`
Set TARDIM's exterior to a skin
**Parameters**
1. skin `string` exterior name e.g. "TARDIM Type 2k18" or "TARDIM Soviet Chronobox"
**Throws if**
1. Skin was not found
---
### `getSkins()`
Get all list of all available exteriors
**Returns**
1. `table` list of exteriors' names
---
### `setSkin(skin)`
Set TARDIM's exterior to a skin
**Parameters**
1. skin `string` exterior name e.g. "TARDIM Type 2k18" or "TARDIM Soviet Chronobox"
---
### `cloisterBell()`
Play the cloister bell sound in the exterior (originates from the peripheral block)
**Throws if**
1. There was an error playing the sound (unlikely)
---
### `getBiomes()`
Get all list of all existing biomes
**Returns**
1. `table` list of biomes' names
---
### `getDimensions()`
Get all list of all existing dimensions
**Returns**
1. `table` list of dimensions' names

View file

@ -0,0 +1,23 @@
# ![Peripheral model](../../assets/img/blocks/fuel_storage.png) Fuel Storage Block
This peripheral, attached to a TARDIM fuel storage block, gives you access to 2 fuel-related methods
Attach name - `"tardim_fuel_storage"`
## Methods
### `getFuel()`
Get how much fuel the TARDIM has.
**Returns**
1. `number` The amount of fuel, from 0 to 100. Not rounded.
---
### `calculateFuelForJourney()`
Get how much fuel the TARDIM would use if you travelled to destination.
**Returns**
1. `number` The amount of fuel

View file

@ -0,0 +1,64 @@
# ![Peripheral model](../../assets/img/blocks/scanner.png) TARDIM Scanner Block
This peripheral, attached to TARDIM's scanner block, lets you fetch some data related to world's environment
Attach name - `"tardim_scanner"`
## Methods
### `getOwnerName()`
Will write the given input to the linked display.
**Returns**
1. `string` The username of TARDIM's owner
---
### `getCompanions()`
Get all list of all companions in the TARDIM
**Returns**
1. `table` list of companions' names
---
### `getOnlinePlayers()`
Get all list of all online players
**Returns**
1. `table` list of players' names
---
### `getSkins()`
Get all list of all available exteriors
**Returns**
1. `table` list of exteriors' names
---
### `getBiomes()`
Get all list of all existing biomes
**Returns**
1. `table` list of biomes' names
---
### `getDimensions()`
Get all list of all existing dimensions
**Returns**
1. `table` list of dimensions' names

View file

@ -0,0 +1,52 @@
# ![Peripheral model](../../assets/img/blocks/rotor.png) Rotor Block
This peripheral, attached to TARDIM's time rotor, allows you to get info about TARDIM's flight status.
Attach name - `"tardim_rotor"`
## Methods
### `isInFlight()`
Check whether the TARDIM is in flight
**Returns**
1. `bool` Whether the TARDIM is in flight
---
### `getTimeEnteredFlight()`
Get UNIX timestamp of when the TARDIM entered flight
**Returns**
1. `number` Unix timestamp or -1 if TARDIM is landed
---
### `getCurrentLocation()`
Retrieve the TARDIM's current location
**Returns**
1. `table` The location of the tardim:
```
{
dimension = "minecraft:overworld", -- Dimension string
pos = { -- Coordinates
x = 1,
y = 2,
z = 3
}
}
```
---
### `getTravelLocation()`
The same as `getCurrentLocation()` but for destination

3
docs/create/index.md Normal file
View file

@ -0,0 +1,3 @@
# Create compatibility
This is not yet implemented due to lack of Create Fabric for 1.20. However, I have a few working 1.19.2 display sources that I intend to add when Create is out.

View file

@ -1,3 +1,4 @@
## Welcome to TARDIM: IC docs!
This mod aims to improve TARDIM by adding new features and integration with other mods such as ComputerCraft or Create.
Please note that v1.2 is a big jump in terms of rewrites and new features. Therefore, not all features are available yet. If you see errors in the docs, feel free to point it out in Discord.

6
docs/mixins.md Normal file
View file

@ -0,0 +1,6 @@
# Changes to vanilla TARDIM
## New fuel system
With TARDIM: In Control, you can insert any furnace-compatible fuel into the fuel storage block without having to make a datapack for it.
Also, buckets will no longer disappear from hopper, and only their contents will be taken.

6
docs/planned.md Normal file
View file

@ -0,0 +1,6 @@
# Planned features
I do not guarantee these will be added or have a timeline, but here are features I designed and wish to implement in the future
* ![Block model](assets/img/blocks/tardim_dock.png) TARDIM Dock - A block that lets you get to a location by a simple ID and handles location and rotation for you. This will also let TARDIMs land on Create: Aeronautics contraptions once that mod is out
* ![Item texture](assets/img/blocks/cartridge_blue.png) Location cartridges - No code way to save location to an item and travel there whenever you want.
* ![Wearable model](assets/img/blocks/jammer.png) Personal location jammer - Wearable item that lets you prevent others from locking onto your position.

View file

@ -1 +0,0 @@
# Crafting recipes for the mod's blocks