From f311931a933116aa48cd0f5d0960a4d81232da64 Mon Sep 17 00:00:00 2001 From: aspwil <65490493+aspwil@users.noreply.github.com> Date: Tue, 1 Dec 2020 21:26:58 -0700 Subject: [PATCH 01/11] Create README.md --- README.md | 78 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 78 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..9ea3ebb --- /dev/null +++ b/README.md @@ -0,0 +1,78 @@ +# NDBallSim +Program in NDBall (https://esolangs.org/wiki/NDBall) + +this is a java program so it run it install java 13+ and run this in command line + +java -jar "path/to/NDBallSim.jar" "path/to/file.nds" + +the standard file format for saving NDBall files is .nds (N-Dimensinal Space), there structure is identical to just a .txt file, so oyu can use .txt files for storing code if you wish + +the args are a bunch of tags as listed below + +-h -help : This shows help +-l -log : This will log extra things in the terminal, such as the ball's position at each step, when memory cells are written to etc +-d -docs : This shows some basic documentation about how to program in NDBall +-s -step : goes through the sim one step at a time, automaticly enables log +-m -max (num) : only runs a max number of steps for the ball (default 10k) use a negative number for unlimited steps +-i -info : spits out info about the program after it completes + +the -d tag show some basic docs as follows: + +the ball starts at 0,0,0... + +dimensions are 5 spaces long (from 0 to 4) + +all instructions take up a cell in the n-dim space + +cells are defined with the following syntax + +POS INSTR EX: (0,1,...) >1 + +position are assumed to in the 0th position for all undefined positions +EX: (1,1,0) = (1,1) + +position can also be defined as a list of dim|value as this +EX: {0,1|5,1} = (1,0,0,0,0,1) +this is useful for defining things instead of using a lot of zeros + +the ball moves along dimensions according to movement instructions + +>n :ball moves forward on dim n +3), if the ball's movement is the same as the cell direction then the memory cell is written to, becoming the balls value. if not the cell is read and the ball becomes the value of the memory cell. they start with a value of 0 + +APIOFORMS: +these instructions allows you to keep a single value apart from the balls value and change it +a :an apioform joins the hive, increasing the have value by 1 +f :an apioform leaves the hive to polinate flowers, decreasing the value of the hive by 1 +q :the queen leaves the hive, taking all apioforms with her, hive value is now 0 +n :nector attract apioforms to or away from the hive untill its value matches the ball +H :the hive itself, when run into the ball`s value becomes the hive value +SPECIAL INSTR: +E end program + +Check out the wiki for more info https://esolangs.org/wiki/NDBall From 97b1028210ccf60fa1cbbdc1decfdb1928e112fc Mon Sep 17 00:00:00 2001 From: aspwil <65490493+aspwil@users.noreply.github.com> Date: Tue, 1 Dec 2020 21:27:56 -0700 Subject: [PATCH 02/11] Update README.md --- README.md | 22 ++++++++++++++-------- 1 file changed, 14 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 9ea3ebb..97acb08 100644 --- a/README.md +++ b/README.md @@ -10,14 +10,20 @@ the standard file format for saving NDBall files is .nds (N-Dimensinal Space), t the args are a bunch of tags as listed below -h -help : This shows help + -l -log : This will log extra things in the terminal, such as the ball's position at each step, when memory cells are written to etc + -d -docs : This shows some basic documentation about how to program in NDBall + -s -step : goes through the sim one step at a time, automaticly enables log + -m -max (num) : only runs a max number of steps for the ball (default 10k) use a negative number for unlimited steps + -i -info : spits out info about the program after it completes the -d tag show some basic docs as follows: + the ball starts at 0,0,0... dimensions are 5 spaces long (from 0 to 4) @@ -37,20 +43,20 @@ this is useful for defining things instead of using a lot of zeros the ball moves along dimensions according to movement instructions ->n :ball moves forward on dim n -n :ball moves forward on dim n + Date: Tue, 1 Dec 2020 21:28:51 -0700 Subject: [PATCH 03/11] Update README.md --- README.md | 61 ------------------------------------------------------- 1 file changed, 61 deletions(-) diff --git a/README.md b/README.md index 97acb08..6694605 100644 --- a/README.md +++ b/README.md @@ -21,64 +21,3 @@ the args are a bunch of tags as listed below -i -info : spits out info about the program after it completes -the -d tag show some basic docs as follows: - - -the ball starts at 0,0,0... - -dimensions are 5 spaces long (from 0 to 4) - -all instructions take up a cell in the n-dim space - -cells are defined with the following syntax - -POS INSTR EX: (0,1,...) >1 - -position are assumed to in the 0th position for all undefined positions -EX: (1,1,0) = (1,1) - -position can also be defined as a list of dim|value as this -EX: {0,1|5,1} = (1,0,0,0,0,1) -this is useful for defining things instead of using a lot of zeros - -the ball moves along dimensions according to movement instructions - - >n :ball moves forward on dim n - 3), if the ball's movement is the same as the cell direction then the memory cell is written to, becoming the balls value. if not the cell is read and the ball becomes the value of the memory cell. they start with a value of 0 - -APIOFORMS: -these instructions allows you to keep a single value apart from the balls value and change it -a :an apioform joins the hive, increasing the have value by 1 -f :an apioform leaves the hive to polinate flowers, decreasing the value of the hive by 1 -q :the queen leaves the hive, taking all apioforms with her, hive value is now 0 -n :nector attract apioforms to or away from the hive untill its value matches the ball -H :the hive itself, when run into the ball`s value becomes the hive value -SPECIAL INSTR: -E end program - -Check out the wiki for more info https://esolangs.org/wiki/NDBall From d81497820c7ee0f731fd1adabf314f131879a5eb Mon Sep 17 00:00:00 2001 From: aspwil <65490493+aspwil@users.noreply.github.com> Date: Tue, 1 Dec 2020 21:29:10 -0700 Subject: [PATCH 04/11] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 6694605..5050884 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ Program in NDBall (https://esolangs.org/wiki/NDBall) this is a java program so it run it install java 13+ and run this in command line -java -jar "path/to/NDBallSim.jar" "path/to/file.nds" +`java -jar "path/to/NDBallSim.jar" "path/to/file.nds"` the standard file format for saving NDBall files is .nds (N-Dimensinal Space), there structure is identical to just a .txt file, so oyu can use .txt files for storing code if you wish From e051db38d7ea6542ee957b3fc7cf85896a2964ca Mon Sep 17 00:00:00 2001 From: aspwil <65490493+aspwil@users.noreply.github.com> Date: Tue, 1 Dec 2020 21:30:33 -0700 Subject: [PATCH 05/11] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 5050884..2cf4039 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@ this is a java program so it run it install java 13+ and run this in command lin `java -jar "path/to/NDBallSim.jar" "path/to/file.nds"` -the standard file format for saving NDBall files is .nds (N-Dimensinal Space), there structure is identical to just a .txt file, so oyu can use .txt files for storing code if you wish +the standard file format for saving NDBall files is .nds (N-Dimensinal Space), there structure is identical to just a .txt file, so you can use .txt files for storing code if you wish the args are a bunch of tags as listed below From 3c91b47f5b87bf29e203e1c9def3fc09711bf7c4 Mon Sep 17 00:00:00 2001 From: aspwil <65490493+aspwil@users.noreply.github.com> Date: Tue, 1 Dec 2020 21:30:55 -0700 Subject: [PATCH 06/11] Update README.md --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 2cf4039..5b4731f 100644 --- a/README.md +++ b/README.md @@ -9,6 +9,7 @@ the standard file format for saving NDBall files is .nds (N-Dimensinal Space), t the args are a bunch of tags as listed below +``` -h -help : This shows help -l -log : This will log extra things in the terminal, such as the ball's position at each step, when memory cells are written to etc @@ -19,5 +20,5 @@ the args are a bunch of tags as listed below -m -max (num) : only runs a max number of steps for the ball (default 10k) use a negative number for unlimited steps --i -info : spits out info about the program after it completes +-i -info : spits out info about the program after it completes``` From ea545fb82bb66d6e3bee326385c2d20c90e359a8 Mon Sep 17 00:00:00 2001 From: aspwil <65490493+aspwil@users.noreply.github.com> Date: Tue, 1 Dec 2020 21:31:12 -0700 Subject: [PATCH 07/11] Update README.md --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 5b4731f..a02293a 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,8 @@ the args are a bunch of tags as listed below ``` -h -help : This shows help --l -log : This will log extra things in the terminal, such as the ball's position at each step, when memory cells are written to etc +-l -log : This will log extra things in the terminal, such as the ball's position at each step, + when memory cells are written to etc -d -docs : This shows some basic documentation about how to program in NDBall From 4d7a3d2e7d019cdb4a7cb1ee065ec0bbfdaf9948 Mon Sep 17 00:00:00 2001 From: aspwil <65490493+aspwil@users.noreply.github.com> Date: Tue, 1 Dec 2020 21:31:50 -0700 Subject: [PATCH 08/11] Update README.md --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index a02293a..d78a3e5 100644 --- a/README.md +++ b/README.md @@ -9,7 +9,7 @@ the standard file format for saving NDBall files is .nds (N-Dimensinal Space), t the args are a bunch of tags as listed below -``` +` -h -help : This shows help -l -log : This will log extra things in the terminal, such as the ball's position at each step, @@ -21,5 +21,5 @@ the args are a bunch of tags as listed below -m -max (num) : only runs a max number of steps for the ball (default 10k) use a negative number for unlimited steps --i -info : spits out info about the program after it completes``` +-i -info : spits out info about the program after it completes` From 3cfce0f5161db3622afaed8b79f711b149da82f3 Mon Sep 17 00:00:00 2001 From: aspwil <65490493+aspwil@users.noreply.github.com> Date: Tue, 1 Dec 2020 21:32:05 -0700 Subject: [PATCH 09/11] Update README.md --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index d78a3e5..1ccb2af 100644 --- a/README.md +++ b/README.md @@ -9,7 +9,7 @@ the standard file format for saving NDBall files is .nds (N-Dimensinal Space), t the args are a bunch of tags as listed below -` +`` -h -help : This shows help -l -log : This will log extra things in the terminal, such as the ball's position at each step, @@ -21,5 +21,5 @@ the args are a bunch of tags as listed below -m -max (num) : only runs a max number of steps for the ball (default 10k) use a negative number for unlimited steps --i -info : spits out info about the program after it completes` +-i -info : spits out info about the program after it completes`` From 10edc414fdb90ad64f5e85501759c18e22b7dcbe Mon Sep 17 00:00:00 2001 From: aspwil <65490493+aspwil@users.noreply.github.com> Date: Tue, 1 Dec 2020 21:32:17 -0700 Subject: [PATCH 10/11] Update README.md --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 1ccb2af..a02293a 100644 --- a/README.md +++ b/README.md @@ -9,7 +9,7 @@ the standard file format for saving NDBall files is .nds (N-Dimensinal Space), t the args are a bunch of tags as listed below -`` +``` -h -help : This shows help -l -log : This will log extra things in the terminal, such as the ball's position at each step, @@ -21,5 +21,5 @@ the args are a bunch of tags as listed below -m -max (num) : only runs a max number of steps for the ball (default 10k) use a negative number for unlimited steps --i -info : spits out info about the program after it completes`` +-i -info : spits out info about the program after it completes``` From e84086c094c14116c4cb087ab9a95f2085e58631 Mon Sep 17 00:00:00 2001 From: aspwil <65490493+aspwil@users.noreply.github.com> Date: Tue, 1 Dec 2020 21:32:28 -0700 Subject: [PATCH 11/11] Update README.md --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index a02293a..ad024f5 100644 --- a/README.md +++ b/README.md @@ -21,5 +21,6 @@ the args are a bunch of tags as listed below -m -max (num) : only runs a max number of steps for the ball (default 10k) use a negative number for unlimited steps --i -info : spits out info about the program after it completes``` +-i -info : spits out info about the program after it completes +```