Skip to content

Conversation

@awjuliani
Copy link
Contributor

Due to a bug in 2017.1, we are setting the default version of the UnitySDK project to 2017.4.

@awjuliani
Copy link
Contributor Author

@xiaomaogy Can you update the migrating document?

overviews each step, in addition to a Docker set-up.

## Install **Unity 2017.1** or Later
## Install **Unity 2017.4.10f1** or Later
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does it have to be 2017.4.10 or later? Could it be any version of 2017.4?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we should just say 2017.4

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

But we haven't tested on 2017.4's early versions, have we?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I guess people will just raise issues when it doesn't work, will change.

packages, `mlagents.env` and `mlagents.trainers`. `mlagents.env` can be used
to interact directly with a Unity environment, while `mlagents.trainers`
contains the classes for training agents.
* The supported Unity version has changed from `2017.1 or later` to `2017.4.10f1 or later`. The lower versions might still work, but you may encounter error that looks like this:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we want 2017.4 here as well?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cap line length to 80 characters (minus code samples and things that need to be verbatim).

to interact directly with a Unity environment, while `mlagents.trainers`
contains the classes for training agents.
* The supported Unity version has changed from `2017.1 or later` to `2017.4.10f1 or later`. The lower versions might still work, but you may encounter error that looks like this:
```
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can specify highlighting with ```console

Instance of CoreBrainInternal couldn't be created. The the script class needs to derive from ScriptableObject.
UnityEngine.ScriptableObject:CreateInstance(String)
```
You can fix the error by removing `CoreBrain` from the CoreBrainInternal.cs:16, click on your Brain Gameobject to let the scene recompile all the changed C# scripts, then add the `CoreBrain` back. (Make sure your brain is in Internal mode, and your TensorFlowSharp plugin is imported and ENABLE_TENSORFLOW flag is set), but this fix is only valid locally and unstable.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cap line length to 80 characters (minus code samples and things that need to be verbatim).

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i would consider a few changes. In migrating.md - indicate that we are now following Unity's LTS for support going forward in the future starting with 2017.4.. . Indicate this helps us maintain good quality and support, etc.. and that future version of ML-agents using Unity's LTS versions will be supported but only in those future versions

I would move the 2017.1 issue into either FAQ and provide a link to it (i.e. if you are still using older versions, see here for known issues in 0.5). We should not necessarily call it out here

Lastly, I would add a note in the main read about our moving over to the LTS supported versions of Unity.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@unityjeffrey

  1. What does "and that future version of ML-agents using Unity's LTS versions will be supported but only in those future versions" mean?
  2. What is the "main read"?

@xiaomaogy xiaomaogy merged commit ebe8031 into release-v0.5 Sep 5, 2018
@xiaomaogy xiaomaogy deleted the release-unity-version branch September 5, 2018 21:34
@github-actions github-actions bot locked as resolved and limited conversation to collaborators May 19, 2021
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants