The Ouroboros King Modding Docs Help

Pieces

Pieces

Pieces can be added both through text mods and script mods.
See the respective documentation for more information on how to add pieces.

Movement

Pieces are defined by their movement, which is a string in a modified version of Betza's Funny Notation.
Betza's Funny Notation consists of a list of characters that represent the movement of a piece.
There are five types of characters:

  • Atom: Capital characters that represent a 'leap'. For example, 'N' represents a knight's move, and BK represents a piece that moves like a bishop and a king. Atoms are in all directions unless a direction modifier prefix is used.

  • Repeat: Number characters that represent the number of times an atom is repeated. For example, 'K3' represents a king that moves three squares in any direction. Repeat characters are optional and default to 1. A repeat of 0 means infinite repeats. Alternatively, the atom character can be repeated to also represent infinite repeats (e.g. 'WW' for a wazir that moves any number of squares in any cardinal direction).

  • Modifier: Lowercase characters that modify the direction or other properties of the atom. For example, 'fB' represents a bishop that moves only forward, and 'cQ' represents a queen that only captures.

  • Chain: A symbol that chains two atoms together. For example, 'K-N' represents a piece that moves like a king, then like a knight.

  • Separator: A symbol that separates two groups of atoms. For example, 'K-B|N' represents a piece that moves like a king then bishop, or like a knight.

Atom Characters

Character

Piece Type

Vector

Description

W

Wazir

(1,0)

Moves one square orthogonally.

F

Ferz

(1,1)

Moves one square diagonally.

D

Dabbaba

(2,0)

Moves two squares orthogonally.

N

Knight

(2,1)

Moves in an L-shape: two squares in one direction, then one in a perpendicular direction.

A

Alfil

(2,2)

Moves two squares diagonally.

H

Threeleaper

(3,0)

Moves three squares orthogonally.

M

Camel

(3,1)

Moves 3/1 squares in an L-shape: three squares in one direction, then one in a perpendicular direction.

Z

Zebra

(3,2)

Moves 3/2 squares in an L-shape: three squares in one direction, then two in a perpendicular direction.

G

Tripper

(3,3)

Moves three squares diagonally.

(x,y)

Custom

(x,y)

Moves x/y squares: x squares in one direction, then y in a perpendicular direction.

Compound Characters

Character

Piece Type

Components

Description

K

King

WF

Moves one square in any direction.

B

Bishop

FF

Moves any number of squares diagonally.

R

Rook

WW

Moves any number of squares orthogonally.

Q

Queen

BR

Moves any number of squares diagonally or orthogonally.

Modifier Characters

Character

Description

f

Forward: Moves only to the most forward square(s).

r

Right: Moves only to the most right square(s).

b

Backward: Moves only to the most backward square(s).

l

Left: Moves only to the most left square(s).

v

Vertical: Compound of f and b. Moves only to the most forward or backward square(s).

h

Horizontal: Compound of r and l. Moves only to the most right or left square(s).

a

Any: Moves to any of the squares. Same as not using a modifier.

fh

Forward Half: Moves only to any square(s) that move forward

rh

Right Half: Moves only to any square(s) that move right

bh

Backward Half: Moves only to any square(s) that move backward

lh

Left Half: Moves only to any square(s) that move left

fs

Forward Sideways: Moves only to any square(s) that move forward sideways: fh but not f.

rs

Right Sideways: Moves only to any square(s) that move right sideways: rh but not r.

bs

Backward Sideways: Moves only to any square(s) that move backward sideways: bh but not b.

ls

Left Sideways: Moves only to any square(s) that move left sideways: lh but not l.

fr

Forward Right: Moves only to the most forward-right square(s).

br

Backward Right: Moves only to the most backward-right square(s).

bl

Backward Left: Moves only to the most backward-left square(s).

fl

Forward Left: Moves only to the most forward-left square(s).

f^

Forwardmost Right: Moves only to the most forwardmost right square.

f_

Forwardmost Left: Moves only to the most forwardmost left square.

r^

Rightmost Forward: Moves only to the most rightmost forward square.

r_

Rightmost Backward: Moves only to the most rightmost backward square.

b^

Backwardmost Right: Moves only to the most backwardmost right square.

b_

Backwardmost Left: Moves only to the most backwardmost left square.

l^

Leftmost Forward: Moves only to the most leftmost forward square.

l_

Leftmost Backward: Moves only to the most leftmost backward square.

s

Same as Previous: Moves in the same direction as the previous chain.

m

Move: Moves only to squares where a capture cannot be made.

c

Capture: Moves only to squares where a capture can be made.

j

Jump: May jump over one piece in the path.

jj

Jump Many: May jump over any number of pieces in the path.

g

Grasshopper: Must jump over one piece in the path and land on the next square.

o

Cylinder: Moves as if the board wraps around in the direction.

y

Fly: Flies over obstacles (boulders, bombs), but not pieces.

q

Bounce: Bounces off the edge of the board once.

x

Destroy Obstacles: Can capture obstacles (boulders, bombs).

d

Backstab: Can capture friendly pieces.

Chain Characters

Character

Description

-

Blocking Chain: Moves like the first atom, then like the second atom. Cannot jump the piece the left chain ends on.

+

Non-Blocking Chain: Moves like the first atom, then like the second atom. Can jump the piece the left chain ends on.

-!

Blocking Forced Chain: Moves like the first atom, then like the second atom. Cannot jump the piece the left chain ends on. The move may not end during the left chain.

+!

Non-Blocking Forced Chain: Moves like the first atom, then like the second atom. Can jump the piece the left chain ends on. The move may not end during the left chain.

-/

Blocking Half-Forced Chain: Moves like the first atom, then like the second atom. Cannot jump the piece the left chain ends on. The move may end on the end of the left chain.

+/

Non-Blocking Half-Forced Chain: Moves like the first atom, then like the second atom. Can jump the piece the left chain ends on. The move may end on the end of the left chain.

Separator Characters

Character

Description

|

Separator: Moves like the first atom, or like the second atom.

Examples

  • mBcK: A piece that moves like a bishop and captures like a king.

  • W-B|F-R: A piece that moves like a wazir, then like a bishop, or like a ferz, then like a rook (Andromeda).

  • WB: A piece that moves like a wazir or a bishop.

  • fW3: A piece that moves forward up to 3 squares.

  • brB: A piece that moves diagonally backward-right like a bishop.

Old notation

The old notation is still supported for compatibility reasons. It is a string in the format of (a,r,f,b),(a,r,f,b),...;(a,r,f,b),(a,r,f,b),..., a = ahead, r = right, f = forward, b = backward. The first group is the non-capturing movement, and the second group is the capturing movement. For example, (1,0,1,1):(0,1,1,1):(1,1,1,1):(1,-1,1,1);(1,0,1,1):(0,1,1,1):(1,1,1,1):(1,-1,1,1) represents a piece that moves like a king.

Last modified: 14 december 2024