BSL:Introduction: Difference between revisions

BSL:Introduction (view source)

Revision as of 21:49, 2 November 2017

20 bytes removed , 2 November 2017

m

opening wording

Iritscen

Bureaucrats, Interface administrators, Suppressors, Administrators

19,286

edits

@@ Line 1: / Line 1: @@
-This page gives a brief look at [[BSL]], Oni's scripting language, for those with scripting or programming experience. For those familiar with a typical procedural language like C, BSL's syntax and concepts will be very familiar, but BSL's feature set is stripped down to a degree that is simpler than even most scripting languages. For details on any aspect of the language, look at [[BSL:Manual]].
+This page gives a brief look at [[BSL]], Oni's scripting language. For those with scripting or programming experience, BSL's syntax and concepts will be very familiar, but BSL's feature set is simpler than most scripting languages. For details on any aspect of the language, as well as documentation of potentially-serious quirks in certain features of the language, read the [[BSL:Manual|BSL Manual]].
 {{TOClimit|2}}
 ==Files==
-When Oni loads a level, it also loads and parses all .bsl files in the folder in [[IGMD]] which contains that level's scripts (the name of this folder being specified by the level's [[ONLV]] resource). Like C, the code automatically begins running at the time of level-load with the function called "main", regardless of which .bsl file it is found in (Oni's scripts always place it in a file called *_main.bsl).
+When Oni loads a level, it also loads and parses all .bsl files in the folder in [[IGMD]] which contains that level's scripts (the name of this folder being specified by the level's [[ONLV]] resource). Like C, the code automatically begins running with the function called "main" at the time of level-load, regardless of which .bsl file it is found in (the convention in Oni's scripts is to place it in a file called *_main.bsl).
 Unlike C, there are other "entry points" in the code. For instance, characters can call script functions upon death and trigger volumes can call functions when they are entered or exited. See [[CHAR]], [[OBD:BINA/OBJC/CONS|BINA CONS]], [[OBD:BINA/OBJC/DOOR|BINA DOOR]], [[NEUT]], and [[TRGV]] for all known places in the game data that can trigger BSL functions.
-Note that the optional [[IGMD/global|global]] folder is also loaded for all levels, but any function found in a .bsl file in global/ will be stranded, only accessible by [[Developer Mode|developer console]], unless you edit an existing function in a level script, or one of the above types of game data in some level, so that it calls your global function.
+Note that the optional [[IGMD/global|global]] folder is also loaded for all levels, but any function found in a .bsl file in global/ will be stranded, only accessible by [[Developer Mode|developer console]], unless it is called by a function in a level script or by one of the above types of game data in that level.
 ==Syntax==