A Pseudo-Coding Language Format made in contribution of (@Isaglish , @JP16D , @Qma and @Vex Ave) base from Fancade's Coding.

(*Note: this is not a real or existent coding language as the word "Pseudo" declares this is just a code format that can be used in scripting discussions)

This page is collection of information regarding of Text Scripts/Scripting (Including : Fancade's Possible Inner Codes & How they work and Fancade's Text Format for a quick Information Sharing during discussions about scripting in Fancade).

Table of Contents

Fancade Coding Text Format
Syntax
- Examples
- Datatypes
  - Example

Fancade Coding Text Format

This Format will be a basis when sharing or suggesting some codes and code solutions during script discussions. Take this as an easier way to share or suggest a code program instead doing it in fancade and go back to fancade server #scripting channel. Well in case of people that couldn't understand this … Sorry we can't do anything about it :P so just do the thing in fancade , screenshot it and share it to them.

Introduction

This format is based on C# syntax. Most of things are simplified for the better understanding.

As you know , Fancade's script blocks are located in different folders. To make it easier to understand , what it means , use their names as in the example below. It's not necessary and takes such a time to write , but please pay attention to it when you're explaining script to the new user or there are namesake custom blocks.

Following the C# syntax , let's imagine that each folder is a separate class with its own fields and functions. So , to represent Get Frame block , you need to type Game.Frame. Again , it's not necessary , just Frame is fine too.

All the cases:

//If block has yellow wires, add () at the end of the name
Game.Win();
Sound.PlaySound();

//If block has inputs, count them and their type in the brackets
Objects.SetPosition(obj object, vec position, rot rotation);

//If block has more than one output you will need to define them individually 
//Use '.outputname' after the function to define them
Objects.GetPosition(target_object).position;

//Math block counts like this, except the basic ones listed below
vec result = Math.LineVsPlane(from, to, normal, point);

//If block has only outputs, don't do anything
num frame = Game.Frame;

____________________________________

Basics

____________________________________

Value Types

//Variables and Data Types
num varName = 0;
tru varName = true/false;
vec varName = (x , y , z);
rot varName = (x , y , z);
obj varName = MyBlocks.BlockName;

//To make global variables, simply add a $ sign as a prefix of a variable name
obj me = Myblocks.Me
vec $myPosition = Objects.GetPosition(me).position

//Any variable can be used as list by using the format: varName[index]

____________________________________

Basic Math Operators

____________________________________

//Add Numbers
2 + 2

//Subtract Numbers
2 - 2

//Multiply Numbers
2 * 2

//Divide Numbers
2 / 2

//Power
2 ^ 2

//Modulo
2 % 2

//Increase
num++

//Decrease
num--

____________________________________

Basic Boolean Operators

____________________________________

//Boolean logic (and, or, not)

tru smart = ((not dumb) and (has_brain)) or already_smart;

//Math (Greater, Less, Equal)

tru equal = a == b;

tru greater = a > b;

tru less = a < b;

tru lessThanOrEqual = a <= b;

tru greaterThanOrEqual = a >= b;

____________________________________

Game Folder

____________________________________

Game.Win();

Game.Lose();

Game.SetScore(num Score);

Game.SetCamera(vec Position, rot Rotation, num Distance);

Game.SetLight(vec Position, rot Rotation);

Game.ScreenSize.x
Game.ScreenSize.y

Game.Accelerometer

Game.Frame

____________________________________

Objects

____________________________________

Objects.GetPosition(obj).position
Objects.GetPosition(obj).rotation

Objects.SetPosition(obj Object, vec position, rot Rotation);

//alternative
//get
vec = obj.position;
//set
obj.position = vec;

Objects.Raycast(vec, vec).hit
Objects.Raycast(vec, vec).hitPos
Objects.Raycast(vec, vec).hitObj

Objects.GetSize(obj Object).min
Objects.GetSize(obj Object).max

Objects.CreateObject(obj Object);

Objects.DestroyObject(obj Object);

____________________________________

Sound

____________________________________

Sound.PlaySound(num Volume, num Pitch);
num sfx = Sound.PlaySound(num Volume, num Pitch).channel

Sound.StopSound(num Channel);

Sound.VolumePitch(num Channel, num Volume, num Pitch);

____________________________________

Physics

____________________________________

//I regret doing this, sorry

____________________________________

Control

____________________________________

//Basic if operator
If (condition) { 
    function_true;
} else { 
    function_false;
}

Loop(num start = 0, num end = 0) {
    //Output
    self.currentIndex
}

TouchSensor() { 
    //Outputs
    self.screen.x
    self.screen.y
}

Collision(obj PhysicalObject) {
    //Outputs
    self.secondObject
    self.normal
    self.impulse
}

SwipeSensor() {
    //Output
    self.direction
}

BoxArt() {
}

PlaySensor() {
}

LateUpdate() {
}

____________________________________

Math

____________________________________

Math.Negate(num Num)

Math.Inverse(rot Rot)

vec.Scale(num Num)

vec.Rotate(rot Rot)

rot.Combine(rot Rot2)

Math.Random(num Min = 0, num Max = 1)

Math.RandomSeed(num Seed);

Math.Min(num Num1, num Num2)

Math.Max(num Num1, num Num2)

Math.Sin(num Num)

Math.Cos(num Num)

Math.Round(num Num)

Math.Floor(num Num)

Math.Ceiling(num Num)

Math.Absolute(num Num)

Math.Log(num Number, num Base)

// break vectors into number variables.
num = vec.x
num = vec.y
num = vec.z

vec.Normalize

vec.Dot(vec Vector)

vec.Cross(vec Vector)

// break a rotation into number variables.
num rot.x
num rot.y
num rot.z

Math.Distance(vec Vec1, vec Vec2)

Math.LERP(rot From, rot To, num Amount)

Math.AxisAngle(vec Axis, num Angle)

Math.ScreenToWorld(num ScreenX, num ScreenY)

Math.WorldToScreen(vec WorldPos)

Math.LineVsPlane(vec From, vec To, vec Point, vec Normal)

Math.LookRotation(vec Direction, vec Up)

Syntax

Ever wondered how Fanscript would look in text format? Well, you can see all references in this directory!

Keep in mind that this is a Work-In-Progress project and that all codes you see will not work if you try to write it in say Unity's C#.

Examples

Datatypes consist of:

num Age = 10
vec Position = (10, 1.51, 5)
rot Angle = {0, 90, 0}
tru Hit = True
obj Player = MyBlocks.Player

For the constraints, it'll be the same inside Fancade:

PlaySensor() {
    const constraint = Physics.AddConstraint(base, part, pivot)
    Physics.AngularLimits(constraint, (0, 0, 1), (0, 0, 0))
    Physics.AngularMotor(constraint, (0, 0, 90), (0, 0, 100))
}

In total we have 7 datatypes that includes lists.

Talking about lists here is how you do them in text format:

# set a list variable
vec Positions[0] = (32.1, 5.51, -23.72)

# to access a list
num.Inspect(num phoneNumbers[2])

Datatypes

In Fancade we have a total of 7 datatypes. These datatypes are num, vec, rot, tru, obj, const, and list.

The number type can be either a whole number or in decimals, in the programming world we call these "int" and "float/double".

Here are some examples:

num jumpSpeed = 0.2
vec level = (1, 1, -10)
rot fan = {0.1, 0, 0}
tru blocked = False
obj me = MyBlocks.Me

For the constraint, here is how you do it:

PlaySensor() {
    const constraint = Physics.AddConstraint(base, part, pivot)
    Physics.AngularLimits(const, (0, 0, 1), (0, 0, 0))
    Physics.AngularMotor(const, (0, 0, 90), (0, 0, 100))
}

To create variables simply type: Datatype variableName

And to initialize: Datatype variableName = value

For the lists here is an example:

PlaySensor() {
    obj landmine = MyBlocks.LM
    obj $LM[num $LM] = landmine
    vec $LM[num $LM] = Objects.GetPosition(landmine).position
    num $LM++
}

To access values inside a list:

Loop(0, $landmines) {
    num i = self.currentIndex
    vec landminePositions = vec $LM[num i]
}

Example

Here is Martin Magni's Shepherd game in text format.

# Init
obj $Herder = MyBlocks.Herder
obj Sheep = MyBlocks.Sheep

# Sheep script
TouchSensor("First").touching {
    Physics.AddForce(Sheep, Math.LineVsPlane(Math.ScreenToWorld(self.screen.x, self.screen.y), (0, 2, 0), (0, 2, 0)) - Objects.GetPosition(Sheep).position)
}

num $Dist = Math.Max(Math.Distance(Objects.GetPosition(Sheep).position, Objects.GetPosition($Herder).position), $Dist)

Collision(Sheep) {
    If (this.secondObject == None) {
        Game.Lose(False)
    }
}

# Herder script
If (num $Dist < 2) {
    Game.Win(False)
}
num $Dist = 0

Fancade Wiki

Text Script

Fancade Coding Text Format

Introduction

Basics

Value Types

Basic Math Operators

Basic Boolean Operators

Game Folder

Objects

Sound

Physics

Control

Math

Syntax

Examples

Datatypes

Example