Forums » Advanced Editor Forum » Read Thread

I need help. I'm starting the advanced editor thing, and now it get everything but scrips. What are they? What do they do? Will it make my games better? Is it just to complicated to bother with?

I think you are referring to scripting, or the coding language of CYS (which doesn't have a name but is referred to as "script"). If you can figure out how to script, or alternatively, use HTML,  you can potentially make your games better. You can use script in a variety of ways.

You can find articles on scripting in the "Scripting" section of the Help & Info page.

For a person just learning the fundamentals of Advanced settings I wouldn't recommend using script.

And perhaps the best way to approach them: they work to do certain specific things. If your story works fine without them, don't worry about them. When you find that you want to do something that you cannot do right now, scripts might be able to help you.

Some scripts are more complicated than others. In a nutshell, they make your game better. With the help of scripting, you can change the look of your game, and you can also let your readers name their character.

Of course, I've only said a bit of what scripting's 'magic' can do.

I don't think I'd say scripting "makes your game better". I think it's more accurate to say it gives you more options.

Lots of things you do with scripting can be down in different ways, scripting just gives you more things you can do (and usually in an easier way).

Scripting is very complicated, but if used correctly, is very much worth it. Check out 'The 1st And Last Of The Ninja's' by nmelssx if you want to see what I mean.

I don't understand much, but here's a couple things I've picked up on that are things that you'll use alot if you do use scripts.

 

$PAGETEXT (Enable the scripting on story properties, and create variables)?

 

Text dependent on a variable

After you enable the scripting, a blue symbol like this ':=' should come up by the title of an open page. Click it and it'll open the $PAGETEXT thing. Okay so an example of what you would put into $PAGETEXT would be this:

IF %PARTYCIT = 0 THEN $PAGETEXT := $PAGETEXT + "Unknown<br>"

IF %PARTYCIT = 1 THEN $PAGETEXT := $PAGETEXT + "Citrior: "

IF %PARTYCIT = 2 THEN $PAGETEXT := $PAGETEXT + "Citrior: Deceased<br>"

The IF %_____ =  _ THEN $PAGETEXT := $PAGETEXT + "Insert text dependent on the variable."  is the general format you will use. There are variations such as IF %_____ = _ AND %_____ = _ THEN $PAGETEXT := $PAGETEXT +"Insert text dependent on both variables<br>" which you will be using for a variable depending on another.

The first %___ is where the independent variable variable goes. The smaller _ blanks are the variable values in which must be in order for the text to appear to the reader. If using the second format, the second long ___ after AND % is where the variable that depends on the first one goes. The third long blank blank is the text which shows when both variable requirements are met. There are a few other formats you can use, but these are the ones I use most often and know the most about. Any questions on this?

 

Automatically pick up/drop an item

In the same place.

$ITEMSTATE01 := 0

$ITEMSTATE01 := 1

Use the top script on the page you want it removed on, the bottom script on the page you want it back on. Replace the "01" part with whatever number the item is. Questions?

 

On Page Variable Tricks

This goes, well, on the page itself, though it won't show up when playing through. Long ___ and short _ are same as when I was explaining $PAGETEXT. The drawback on using this is that although it is simpler, it also leaves extra spacing in the story when viewed.

%%___%% is how you get the current value of that variable to show up on the page. It's useful for stats.

%%___%%=%_%Insert text dependent on that variable%%

Here, the '=' can be replaced with '>' which means that if the variable is greater than _ value, then put this text in. It's handy for stats as well.

 

 

 

 

Eventually, once you get the hang of it, you can do things like this; (copied/pasted from a post by nmelssx a while ago. I can't even begin to understand this, but it makes a random name generator.)

This is the script:

%V1 := 0
%V2 := 0
%V3 := 0
%V4 := 0
%V5 := 0
%V6 := 0
%V7 := 0
%V8 := 0

%C1 := 0
%C2 := 0
%C3 := 0
%C4 := 0
%C5 := 0
%C6 := 0
%C7 := 0
%C8 := 0

%ROLL := 1D6

IF %ROLL >= 1 THEN
BEGIN

%ROLL1 := 1D2
IF %ROLL1 = 1 THEN
BEGIN
%C1 := 1D21
%ROLL2 := 2
END

IF %ROLL1 = 2 THEN
BEGIN
%V1 := 1D5
%ROLL2 := 1
END

IF %ROLL2 = 1 THEN
BEGIN
%C2 := 1D21
%ROLL3 := 2
END

IF %ROLL2 = 2 THEN
BEGIN
%V2 := 1D5
%ROLL3 := 1
END

IF %ROLL3 = 1 THEN
BEGIN
%C3 := 1D21
%ROLL4 := 2
END

IF %ROLL3 = 2 THEN
BEGIN
%V3 := 1D5
%ROLL4 := 1
END

END

IF %ROLL >= 2 THEN
BEGIN
IF %ROLL4 = 1 THEN
BEGIN
%C4 := 1D21
%ROLL5 := 2
END

IF %ROLL4 = 2 THEN
BEGIN
%V4 := 1D5
%ROLL5 := 1
END

END

IF %ROLL >= 3 THEN
BEGIN
IF %ROLL5 = 1 THEN
BEGIN
%C5 := 1D21
%ROLL6 := 2
END

IF %ROLL5 = 2 THEN
BEGIN
%V5 := 1D5
%ROLL6 := 1
END

END

IF %ROLL >= 4 THEN
BEGIN
IF %ROLL6 = 1 THEN
BEGIN
%C6 := 1D21
%ROLL7 := 2
END

IF %ROLL6 = 2 THEN
BEGIN
%V6 := 1D5
%ROLL7 := 1
END

END

IF %ROLL >= 5 THEN
BEGIN
IF %ROLL7 = 1 THEN
BEGIN
%C7 := 1D21
%ROLL8 := 2
END

IF %ROLL7 = 2 THEN
BEGIN
%V7 := 1D5
%ROLL8 := 1
END

END

IF %ROLL >= 6 THEN
BEGIN
IF %ROLL8 = 1 THEN
BEGIN
%C8 := 1D21
END

IF %ROLL8 = 2 THEN
BEGIN
%V8 := 1D5
END

END

This is on the page:

%%V1%=%1%A%%%%V1%=%2%E%%%%V1%=%3%I%%%%V1%=%4%O%%%%V1%=%5%U%%%%C1%=%1%B% %%%C1%=%2%C%%%%C1%=%3%D%%%%C1%=%4%F%%%%C1%=%5%G%%%%C1%=%6%H%%%%C1%=%7%J %%%%C1%=%8%K%%%%C1%=%9%L%%%%C1%=%10%M%%%%C1%=%11%N%%%%C1%=%12%P%%%%C1%= %13%Q%%%%C1%=%14%R%%%%C1%=%15%S%%%%C1%=%16%T%%%%C1%=%17%V%%%%C1%=%18%W%% %%C1%=%19%X%%%%C1%=%20%Y%%%%C1%=%21%Z%%%%V2%=%1%a%%%%V2%=%2%e%%%%V2%=%3%i %%%%V2%=%4%o%%%%V2%=%5%u%%%%C2%=%1%b%%%%C2%=%2%c%%%%C2%=%3%d%%%%C2%=%4%f %%%%C2%=%5%g%%%%C2%=%6%h%%%%C2%=%7%j%%%%C2%=%8%k%%%%C2%=%9%l%%%%C2%=%10% m%%%%C2%=%11%n%%%%C2%=%12%p%%%%C2%=%13%q%%%%C2%=%14%r%%%%C2%=%15%s%%%%C2% =%16%t%%%%C2%=%17%v%%%%C2%=%18%w%%%%C2%=%19%x%%%%C2%=%20%y%%%%C2%=%21%z%%% %V3%=%1%a%%%%V3%=%2%e%%%%V3%=%3%i%%%%V3%=%4%o%%%%V3%=%5%u%%%%C3%=%1%b%%% %C3%=%2%c%%%%C3%=%3%d%%%%C3%=%4%f%%%%C3%=%5%g%%%%C3%=%6%h%%%%C3%=%7%j%%% %C3%=%8%k%%%%C3%=%9%l%%%%C3%=%10%m%%%%C3%=%11%n%%%%C3%=%12%p%%%%C3%=%13%q %%%%C3%=%14%r%%%%C3%=%15%s%%%%C3%=%16%t%%%%C3%=%17%v%%%%C3%=%18%w%%%%C3%= %19%x%%%%C3%=%20%y%%%%C3%=%21%z%%%%V4%=%1%a%%%%V4%=%2%e%%%%V4%=%3%i%%%%V4 %=%4%o%%%%V4%=%5%u%%%%C4%=%1%b%%%%C4%=%2%c%%%%C4%=%3%d%%%%C4%=%4%f%%%%C4 %=%5%g%%%%C4%=%6%h%%%%C4%=%7%j%%%%C4%=%8%k%%%%C4%=%9%l%%%%C4%=%10%m%%%%C 4%=%11%n%%%%C4%=%12%p%%%%C4%=%13%q%%%%C4%=%14%r%%%%C4%=%15%s%%%%C4%=%16%t% %%%C4%=%17%v%%%%C4%=%18%w%%%%C4%=%19%x%%%%C4%=%20%y%%%%C4%=%21%z%%%%V5%=% 1%a%%%%V5%=%2%e%%%%V5%=%3%i%%%%V5%=%4%o%%%%V5%=%5%u%%%%C5%=%1%b%%%%C5%=% 2%c%%%%C5%=%3%d%%%%C5%=%4%f%%%%C5%=%5%g%%%%C5%=%6%h%%%%C5%=%7%j%%%%C5%=%8 %k%%%%C5%=%9%l%%%%C5%=%10%m%%%%C5%=%11%n%%%%C5%=%12%p%%%%C5%=%13%q%%%%C5 %=%14%r%%%%C5%=%15%s%%%%C5%=%16%t%%%%C5%=%17%v%%%%C5%=%18%w%%%%C5%=%19%x%% %%C5%=%20%y%%%%C5%=%21%z%%%%V6%=%1%a%%%%V6%=%2%e%%%%V6%=%3%i%%%%V6%=%4%o% %%%V6%=%5%u%%%%C6%=%1%b%%%%C6%=%2%c%%%%C6%=%3%d%%%%C6%=%4%f%%%%C6%=%5%g% %%%C6%=%6%h%%%%C6%=%7%j%%%%C6%=%8%k%%%%C6%=%9%l%%%%C6%=%10%m%%%%C6%=%11%n %%%%C6%=%12%p%%%%C6%=%13%q%%%%C6%=%14%r%%%%C6%=%15%s%%%%C6%=%16%t%%%%C6%= %17%v%%%%C6%=%18%w%%%%C6%=%19%x%%%%C6%=%20%y%%%%C6%=%21%z%%%%V7%=%1%a%%%% V7%=%2%e%%%%V7%=%3%i%%%%V7%=%4%o%%%%V7%=%5%u%%%%C7%=%1%b%%%%C7%=%2%c%%%% C7%=%3%d%%%%C7%=%4%f%%%%C7%=%5%g%%%%C7%=%6%h%%%%C7%=%7%j%%%%C7%=%8%k%%%% C7%=%9%l%%%%C7%=%10%m%%%%C7%=%11%n%%%%C7%=%12%p%%%%C7%=%13%q%%%%C7%=%14%r% %%%C7%=%15%s%%%%C7%=%16%t%%%%C7%=%17%v%%%%C7%=%18%w%%%%C7%=%19%x%%%%C7%=% 20%y%%%%C7%=%21%z%%%%V8%=%1%a%%%%V8%=%2%e%%%%V8%=%3%i%%%%V8%=%4%o%%%%V8%= %5%u%%%%C8%=%1%b%%%%C8%=%2%c%%%%C8%=%3%d%%%%C8%=%4%f%%%%C8%=%5%g%%%%C8%= %6%h%%%%C8%=%7%j%%%%C8%=%8%k%%%%C8%=%9%l%%%%C8%=%10%m%%%%C8%=%11%n%%%%C8 %=%12%p%%%%C8%=%13%q%%%%C8%=%14%r%%%%C8%=%15%s%%%%C8%=%16%t%%%%C8%=%17%v%% %%C8%=%18%w%%%%C8%=%19%x%%%%C8%=%20%y%%%%C8%=%21%z%%