Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
secondlife:scripted_agents:corrade [2020/06/30 00:16]
office
secondlife:scripted_agents:corrade [2020/09/09 14:29] (current)
office [Third-Party Software]
Line 17: Line 17:
 Scripting //​templates//​ are provided in the Corrade store that are closer to an end-product yet they are meant to provide a starting point for programmers by illustrating some of the aspects of programming with Corrade. The //​templates//​ can be changed or created differently (or better) by a programmer that interfaces with Corrade. If a specific targeted application is desired that requires a scripted agent, then chances are that a programmer would be able create one using Corrade. Scripting //​templates//​ are provided in the Corrade store that are closer to an end-product yet they are meant to provide a starting point for programmers by illustrating some of the aspects of programming with Corrade. The //​templates//​ can be changed or created differently (or better) by a programmer that interfaces with Corrade. If a specific targeted application is desired that requires a scripted agent, then chances are that a programmer would be able create one using Corrade.
  
-====== Feature Requests and Bug Reports ====== 
  
-  * If you have a feature request or would like to file a bug [[http://​bugs.grimore.org/​|please use the Corrade ticket system]]. 
-  ​ 
 ====== Requirements ====== ====== Requirements ======
  
-  * Unix (Linux, ​BSDDarwin Mac / OSXmacOS) or Windows +  * Corrade can run on the following platforms and architectures:​ 
-    * On Unix (Linux, BSD, Darwin Mac / OSX, macOSyou will need [[http://​www.mono-project.com|mono]] - you have to install from the [[https://www.mono-project.com/​download/​stable/|mono project download page]] and get the latest release+    * Linux 64bit, 
-      * You will need at least //the latest stable// version of ''​mono''​. Linux distributions tend to bundle old versions of mono so please check the [[https://www.mono-project.com/download/stable/|mono project download page]] for a recent version. +    * Linux ARM 32bit, 
-      * If installing from packages from Xamarin, you will need to install ''​mono-complete'' ​that is, the whole package. +    * MacOS 64bit
-    * On Windows: +    * Windows 64bit (Windows 7 onward) 
-      * You will need [[https://www.microsoft.com/en-gb/download/details.aspx?​id=42642|.NET Framework 4.5.2]]+  * [[https://dotnet.microsoft.com/​download/​dotnet-core/3.1|.NET Core 3.1]] installed for all platforms supported by Corrade. 
-  * x86 or ARM CPU - Corrade can make use of all available cores or CPUs.+    * a fresh Windows 7 install may require a hotfix update after installing .NET Core 3.1
 +      * [[http://download.windowsupdate.com/d/msdownload/update/​software/​secu/​2018/​09/​windows6.1-kb4457144-x64_5ca467d42deadc2b2f4010c4a26b4a6903790dd5.msu|hotfix for x64]] 
 +      * [[http://download.windowsupdate.com/d/msdownload/​update/software/​secu/​2018/​09/​windows6.1-kb4457144-x86_d2d9bc4f25b27fe28b11b2cd18df9b7835f22df3.msu|hotfix for x86]] 
   * 100-350 MB RAM with all options turned on.   * 100-350 MB RAM with all options turned on.
   * DSL onward (Linden Lab recommends cable, not wireless).   * DSL onward (Linden Lab recommends cable, not wireless).
-  * Corrade uses the exact [[https://​community.secondlife.com/​knowledgebase/​english/​using-second-life-with-a-firewall-r599/​|same firewall ports as any other view in Second Life]]. Additionally,​ any Corrade feature that requires an additional port will have to be forwarded to the machine that Corrade runs on.+  * Corrade uses the [[https://​community.secondlife.com/​knowledgebase/​english/​using-second-life-with-a-firewall-r599/​|exact same firewall ports as any other view in Second Life]]. Additionally,​ any Corrade feature that requires an additional port will have to be forwarded to the machine that Corrade runs on.
  
 ====== Download ====== ====== Download ======
  
-**Release** constitute milestones for Corrade ​development and have all the incremental bug fixes and enhancements from the **Continuous** builds.+**The latest ​Corrade** ​is available at:
  
-  * {{https://​ci.grimore.org/​buildStatus/​icon?​job=Corrade%20Release&​.png?​direct}} [[http://​corrade.grimore.org/download/​release|Corrade Release]] +  * {{https://​ci.grimore.org/​buildStatus/​icon?​job=Corrade%20Continuous&​.png?​direct}} [[https://​download.corrade.grimore.org/​continuous/​|Corrade ​11]]
-  * {{https://​ci.grimore.org/​buildStatus/​icon?​job=Corrade%20Continuous&​.png?​direct}} [[http://corrade.grimore.org/​download/continuous|Corrade ​Continuous]]+
  
-The **continuous** releases contain the latest and most up-to-date changes; if you file a bug reportwhen the bug is addressed, ​new continuous ​release ​will be publishedAfter a certain amount of time, ranging from six months to a year, the continuous releases fixes will be rolled up into published **release** build.+where higher version numbers, from left to rightrepresent ​the more recent versions (ie: a release ​with version number ''​11.0.1.2''​ would be newer than a release ​with version number ''​11.0.1.0''​).
  
-With a development life-span for over a decade, Corrade is stable enough for production in either ​**continuous** or **release** builds.+**Older and outdated** versions for Corrade are available at:
  
-====== Setup Instructions ======+  * [[https://​download.corrade.grimore.org/​release/​|Corrade 10 - Continuous]] 
 +  * [[https://​download.corrade.grimore.org/​legacy/​|Corrade 10 - Release]]
  
-Corrade will only work installed as a service in Windows ​and using ''​mono-service''​ on supported Mono platforms such as Linux.+and will be preserved without support until Corrade 11 picks up
  
-To install on Windows, unzip the downloaded file to a new folder, open ''​cmd.exe''​ and then change directory to the Corrade folder and run: +====== Setup Instructions ======
- +
-<code dos> +
-Corrade.exe help +
-</​code>​ +
- +
-it should provide you options to install Corrade as a service. Note that for a release, you can just delete the contents of the folder and then unzip the new release into the same folder without uninstalling the Corrade service each time a new release is out. +
- +
-On supported Mono platforms (Unix), unzip the zip file to a new folder and then issue: +
- +
-<code bash> +
-mono-service -l:​Corrade.exe.lock Corrade.exe +
-</​code>​ +
- +
-To stop Corrade, issue: +
- +
-<code bash> +
-ps ax | grep mono +
-</​code>​ +
- +
-and then send a ''​TERM''​ signal to the mono-service process running ''​Corrade.exe'':​ +
- +
-<code bash> +
-kill -s TERM PID +
-</​code>​+
  
-where ''​PID''​ is the identifier retrieved using the previous commandYou can find more information ​for running ​Corrade ​as a service (Windows) or daemon (Unix) ​on the [[secondlife/scripted_agents/corrade/auto_restart|auto restart page]].+.NET Core has to be installed ​for the platform that Corrade ​runs on, packages for Linux distributions and binaries are available ​on the [[https://dotnet.microsoft.com/download/​dotnet-core/​3.1|Microsoft .NET Core 3.1]] website.
  
-After starting ​the service ​with either ''​services.msc''​ on Windows or through ''​mono-service''​, Corrade will by default open up a port that can be connected to using web browser ​in order to configure the botBy default, the address is:+The Corrade binary can be executed from the extracted folder directly on all platforms ​with no further requirementsUpon executing the binary, Corrade will most likely mention that no configuration has been found and that a webserver named Nucleus has been launched ​in order to perform an initial configuration.
  
-<code> +Redirect your browser at: ''​<nowiki>​http://​127.0.0.1:​54377/</nowiki>''​ on the machine running Corrade - or, access the Nucleus web interface through the network by pointing the browser to ''<​nowiki>​http://​TARGET_MACHINE:​54377/</​nowiki>''​ where ''​TARGET_MACHINE''​ is the hostname or IP address of the machine on which Corrade has been launched.
-http://​127.0.0.1:​54377 +
-</code>+
  
-and can be accessed on the same machine that Corrade is installed on.+//Make sure that all ad-blockers are disabled// ​and, upon accessing ​the Nucleus web interface, authenticate using the ''​nucleus''​ password. When the interface loads, click the ''​Configurator''​ panel and authenticate again with the ''​nucleus''​ password.
  
-===== Quickstart Videos =====+A configuration form should now load up and the minimal required fields to get the bot connected to the SecondLife grid are the following:​ 
 +  * ''​Login''​ -> ''​Firstname'',​ ''​Lastname''​ and ''​Password''​ - these are the credentials of an existing account in SecondLife that the bot will use to connect to the grid, 
 +  * ''​Groups''​ -> ''​Group name''​ and ''​Password''​ - for best results, the group must exist in SecondLife and the password can be any made up string. Both the group name and the group password are used together as an authentication tuple in order to control Corrade via scripts. The "​default"​ or "​example"​ group ''​[Wizardry and Steamworks]:​Support''​ can be edited or removed.
  
-^ Windows 7 ^ Windows 10 ^ +Once the configuration is complete, click the ''​Commit configuration'',​ authenticate again using the ''​nucleus''​ password and wait for the bot to connect to the gridIn case the bot is unable to connect, the errors logs can be consulted under ''​Logs/​Corrade.log''​ in order to attempt and determine the cause.
-| {{video:​secondlife_scripted_agents_corrade_progressive_quickstart.mp4?​480x320}} | {{video:​secondlife_scripted_agents_corrade_progressive_quickstart_10.mp4?​480x320}} |+
  
-Soundtrack: Fury of the Furries+In case all else fails, shut down the bot and remove the ''​Configuration.xml''​ file manually and then restart the bot in order to go through the initial configuration phase again. In order to make adjustments to the configuration,​ simply access the web interface again and use the ''​Configurator''​ tool to make any changes necessary - in most cases, Corrade does not need to be restarted after making configuration changes. In order to run multiple bots, ''​Nucleus.config.default''​ can be renamed to ''​Nucleus.config''​ and then edited in order to change the listening address and port for Nucleus - similarly, the ''​nucleus''​ password can be changed within the same file.
  
-^ Debian Linux ^ +Since Corrade is designed to be a long-running process and given power or Internet outages, the ''​contrib''​ folder contains sub-folders for every supported platform with instructions on how to demonize Corrade.
-| {{video:​secondlife_scripted_agents_corrade_progressive_quickstart_debian.mp4?​780x420}} |+
  
-Soundtrack: The Calico Sequence ( Edward Clark ) - Juno 
 ====== Communications Overview ====== ====== Communications Overview ======
  
Line 151: Line 123:
  
  
-  * [[secondlife/scripted_agents/corrade/api/​progressive|Corrade application programming interface (API)]]+  * [[secondlife:scripted_agents:corrade:api|Corrade application programming interface (API)]]
  
  
Line 166: Line 138:
   * For performance improvements please see the [[secondlife/​scripted_agents/​corrade/​performance considerations|Corrade performance page]].   * For performance improvements please see the [[secondlife/​scripted_agents/​corrade/​performance considerations|Corrade performance page]].
  
-===== Benchmarks and Referential Performance ===== 
- 
-  * Please see the [[secondlife/​scripted_agents/​corrade/​benchmarks|Benchmarks]]. 
  
 ====== Frequently asked Questions (FAQ) ====== ====== Frequently asked Questions (FAQ) ======
Line 202: Line 171:
   * [[https://​www.ovh.com/​us/​index.xml|OVH]] has shared hosting and dedicated hosting (Unix and Windows) with data-centres in Canada and Europe. The pricing starts at USD2.99 or 2.40 EUROs per month. You have to pay for the Windows license separately (you pay to OVH and they pay a Windows license subscription for you).   * [[https://​www.ovh.com/​us/​index.xml|OVH]] has shared hosting and dedicated hosting (Unix and Windows) with data-centres in Canada and Europe. The pricing starts at USD2.99 or 2.40 EUROs per month. You have to pay for the Windows license separately (you pay to OVH and they pay a Windows license subscription for you).
  
-====== Logos and Vanity Items ====== 
- 
-  * [[secondlife/​scripted_agents/​corrade/​logos|Logos and Vanity Items]] 
  
 ====== Contact and Support ====== ====== Contact and Support ======
Line 219: Line 185:
  
 ===== Submitting Bugs or Requesting Features ===== ===== Submitting Bugs or Requesting Features =====
 +
 +If you would like to request a feature or report a bug, please use:
 +
 +  * [[http://​bugs.grimore.org|The Corrade bug reporting system @ https://​bugs.grimore.org]].
  
 To create a bug report, please make sure to provide a minimal, reproducible and complete example of the problem you are experiencing. This roughly includes creating a test scenario with the following points in mind: To create a bug report, please make sure to provide a minimal, reproducible and complete example of the problem you are experiencing. This roughly includes creating a test scenario with the following points in mind:
Line 228: Line 198:
 Providing a minimal, reproducible and complete example speeds up the resolution of an issue greatly since without that a developer will have to make guesses about what you have done and may not be able to see the bug happening. Providing a minimal, reproducible and complete example speeds up the resolution of an issue greatly since without that a developer will have to make guesses about what you have done and may not be able to see the bug happening.
  
-If you would like to request a feature or report a bug, please use: 
- 
-  * [[http://​bugs.grimore.org|The Corrade bug reporting system @ http://​bugs.grimore.org]]. 
 ====== Third-Party Software ====== ====== Third-Party Software ======
  
   * [[https://​github.com/​MidnightRift/​node-corrade|node-corrade]] created by [[secondlife:///​app/​agent/​e6abc6c4-7ada-44af-b248-9b90aaebe0fb/​about|Midnight Rift]] is a node wrapper for Corrade in Node.JS. [[https://​github.com/​MidnightRift/​corrade-linux-server|corrade-linux-server]] is an update and deployment method created by [[secondlife:///​app/​agent/​e6abc6c4-7ada-44af-b248-9b90aaebe0fb/​about|Midnight Rift]].   * [[https://​github.com/​MidnightRift/​node-corrade|node-corrade]] created by [[secondlife:///​app/​agent/​e6abc6c4-7ada-44af-b248-9b90aaebe0fb/​about|Midnight Rift]] is a node wrapper for Corrade in Node.JS. [[https://​github.com/​MidnightRift/​corrade-linux-server|corrade-linux-server]] is an update and deployment method created by [[secondlife:///​app/​agent/​e6abc6c4-7ada-44af-b248-9b90aaebe0fb/​about|Midnight Rift]].
   * [[https://​hub.docker.com/​r/​aphris/​corrade-continuous|Corrade continuous docker]] and [[https://​hub.docker.com/​u/​aphris|additional software for Corrade docker]] created and maintained by [[secondlife:///​app/​agent/​38672086-564d-4070-aab0-81ebefa6d77b/​about|Aphris Karu]].   * [[https://​hub.docker.com/​r/​aphris/​corrade-continuous|Corrade continuous docker]] and [[https://​hub.docker.com/​u/​aphris|additional software for Corrade docker]] created and maintained by [[secondlife:///​app/​agent/​38672086-564d-4070-aab0-81ebefa6d77b/​about|Aphris Karu]].
 +  * [[https://​github.com/​Aphris-Karu/​Free-Corrade-AI|a free AI based on RiveScript]] created by [[secondlife:///​app/​agent/​38672086-564d-4070-aab0-81ebefa6d77b/​about|Aphris Karu]].
   * [[https://​hub.docker.com/​r/​aphris/​corrade-free-ai|AI core]] created and maintained by [[secondlife:///​app/​agent/​38672086-564d-4070-aab0-81ebefa6d77b/​about|Aphris Karu]]. This is an alternative to the [[http://​grimore.org/​secondlife/​scripted_agents/​corrade/​tutorials/​artificial_intelligence/​built-in|corrade-ai software by Wizardry and Steamworks]] that currently uses only SIML (which has commerical limitations) as a backend.   * [[https://​hub.docker.com/​r/​aphris/​corrade-free-ai|AI core]] created and maintained by [[secondlife:///​app/​agent/​38672086-564d-4070-aab0-81ebefa6d77b/​about|Aphris Karu]]. This is an alternative to the [[http://​grimore.org/​secondlife/​scripted_agents/​corrade/​tutorials/​artificial_intelligence/​built-in|corrade-ai software by Wizardry and Steamworks]] that currently uses only SIML (which has commerical limitations) as a backend.
- 
-===== CasperTech ===== 
- 
   * You can find [[http://​wiki.casperdns.com/​index.php/​CorradeBot|details on setting up Corrade on the CasperTech official website]].   * You can find [[http://​wiki.casperdns.com/​index.php/​CorradeBot|details on setting up Corrade on the CasperTech official website]].
  
Line 292: Line 257:
  
 along with the contributors on [[http://​bugs.grimore.org|the Corrade bug reporting page]]. along with the contributors on [[http://​bugs.grimore.org|the Corrade bug reporting page]].
 +
 +====== Logos and Vanity Items ======
 +
 +  * [[secondlife/​scripted_agents/​corrade/​logos|Logos and Vanity Items]]
 +
 ====== Index ====== ====== Index ======
  
 {{indexmenu>​secondlife:​scripted_agents:​corrade}} {{indexmenu>​secondlife:​scripted_agents:​corrade}}

secondlife/scripted_agents/corrade.1593472589.txt.gz · Last modified: 2020/06/30 00:16 by office

Access website using Tor Access website using i2p


For the copyright, license, warranty and privacy terms for the usage of this website please see the license, privacy, data protection and copyright compliance as well as the plagiarism pages.