From 199aec0ef5c418ec9c4a8c5c49044dee4b36ef1f Mon Sep 17 00:00:00 2001 From: codeviolet <12992687+codeviolet@users.noreply.github.com> Date: Fri, 1 Sep 2017 15:58:12 +1000 Subject: [PATCH] Add IMPORT_GUIDE and edit README --- AVsitter2/IMPORT_GUIDE.md | 41 +++++++++++++++++++++++++++++++++++++++ README.md | 24 ++++++++++++++++------- 2 files changed, 58 insertions(+), 7 deletions(-) create mode 100644 AVsitter2/IMPORT_GUIDE.md diff --git a/AVsitter2/IMPORT_GUIDE.md b/AVsitter2/IMPORT_GUIDE.md new file mode 100644 index 0000000..1e561c8 --- /dev/null +++ b/AVsitter2/IMPORT_GUIDE.md @@ -0,0 +1,41 @@ + +The AVsitter2 scripts can be freely obtained from this GitHub repository and imported into Second Life or OpenSim manually by following the guide below. + +If you would prefer a packaged version of the latest release, and to receive packaged [in-world updates](https://avsitter.github.io/updates.html) of future releases, visit the [SL Marketplace](https://marketplace.secondlife.com/stores/79645). Proceeds from marketplace sales are shared with open-source contributors and will help support continued development of AVsitter. + + +## Importing the AVsitter2 scripts into Second Life / OpenSim + +1. Visit the [AVsitter project releases page](https://github.com/AVsitter/AVsitter/releases) and download the ```.zip``` file for the latest AVsitter2 release to your computer. + +- Unpack the file you downloaded to a folder where you plan on keeping your AVsitter distributions. + +- In your Second Life inventory, locate a suitable place and create a folder named AVsitter, where you'll save all the scripts and needed objects. + +- For each ```.lslo``` file that you unpacked from the ```.zip``` file, create a new script in your Second Life inventory and rename it to match exactly the same name as the file you unpacked, but without the ```.lslo``` at the end of the name. + + For example, if the script you unpacked was called **[AV]sitA.lslo** then the script you create in Second Life should be named simply **[AV]sitA**. The name of the script is important! Do not add ```.lslo``` at the end of the name. + +- For each script you just created in Second Life: + - Open the script in Second Life by double-clicking it. + - Open the corresponding ```.lslo``` file on your computer with a plain text editor (e.g. Notepad). + - Select All text in the file (CTRL-A) and Copy (CTRL-C). + - In SL, replace the script's content with the text you've copied. You can do this by overwriting the text of the default script by Selecting All (CTRL-A) and pasting the code you've copied from your computer's text editor (CTRL-V). + - Once you do this, hit **Save** to compile the script. If you get a script error, then you have not correctly replaced the entire script's contents with the content of the file on your computer. + - No errors? Then proceed similarly with the rest of the scripts. + + When you have finished this process you should have created one script for each ```.lslo``` file that was in the ```.zip``` file, copied the file's contents from your computer and saved it in the corresponding Second Life script. + +- There's still one thing to do to have the distribution working: + + - In Second Life, rez a box and name it **[AV]helper**. + + - Inside its contents, drop the **[AV]helper** script that, at this point, you must have created by following the above procedure. + +After importing the AVsitter2 scripts into Second Life you are ready to follow the [AVsitter2 User Instructions](https://avsitter.github.io/avsitter2_home). Where the instructions mention the **[AV]helper** object, it refers to the object we've just created with the script inside. + + + + + + diff --git a/README.md b/README.md index 780bef6..ce991e6 100644 --- a/README.md +++ b/README.md @@ -1,16 +1,26 @@ # [AVsitter](https://avsitter.github.io)™ -## About +Repository for [AVsitter](https://avsitter.github.io)™ - a furniture pose system for [Second Life](https://www.secondlife.com)® and [Opensim](https://en.wikipedia.org/wiki/OpenSimulator), written in [LSL](https://wiki.secondlife.com/wiki/LSL_Portal). -Repository for [AVsitter](https://avsitter.github.io)™ - a furniture pose system for [Second Life](https://www.secondlife.com)® and [Opensim](https://en.wikipedia.org/wiki/OpenSimulator). +## Getting the AVsitter2 scripts in Second Life/Opensim -* Scripts are written in LSL ([Linden Scripting Language](https://wiki.secondlife.com/wiki/LSL_Portal)). -* User instructions are found at [https://avsitter.github.io](https://avsitter.github.io). -* Contributor guidelines are found [https://avsitter.github.io/contribute.html](https://avsitter.github.io/contribute.html). +1. You can manually import the AVsitter scripts into Second Life / Opensim by following our [AVsitter2 Import Guide](AVsitter2/IMPORT_GUIDE.md). -The AVsitter scripts can be freely obtained from this GitHub repository, however if you would like a packaged version of the latest release, and to receive packaged [in-world updates](https://avsitter.github.io/updates.html) of future releases, visit the [SL Marketplace](https://marketplace.secondlife.com/stores/79645). + *or* -Proceeds are shared with open-source contributors and will help support continued development of AVsitter. Those who purchased AVsitter in the past will continue to receive [in-world updates](https://avsitter.github.io/updates.html) without needing to purchase it again. +2. If you would prefer a pre-packaged version of the latest release, and to receive packaged [in-world updates](https://avsitter.github.io/updates.html) of future releases, then visit the [SL Marketplace](https://marketplace.secondlife.com/stores/79645). Proceeds from marketplace sales are shared with open-source contributors and will help support continued development of AVsitter. + +## User instructions + +User instructions are found at [https://avsitter.github.io](https://avsitter.github.io). + +## Support guide + +Support guidelines are found at [https://avsitter.github.io/support.html](https://avsitter.github.io/support.html). + +## Contributor guidelines + +Contributor guidelines are found at [https://avsitter.github.io/contribute.html](https://avsitter.github.io/contribute.html). ## License