Difference between revisions of "TroubleShootingFAQ"
(Added stencil note) |
(Repair broken links.) |
||
(12 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
'''''Disclaimer''''' : <BR> | '''''Disclaimer''''' : <BR> | ||
This FAQ is not exhaustive, it is always 'under construction', and many things might be missing. If you found a problem that is not covered here, please add it or post about it on the forum. | This FAQ is not exhaustive, it is always 'under construction', and many things might be missing. If you found a problem that is not covered here, please add it or post about it on the forum. | ||
− | |||
'''What is this FAQ?'''<BR> | '''What is this FAQ?'''<BR> | ||
For now this FAQ focuses on problems with Uru and the Tools (essentially PyPRP). Problems that are related only to Blender and modelling/texturing/animating/sound are located in the [[BlenderFAQ|Blender FAQ]]. | For now this FAQ focuses on problems with Uru and the Tools (essentially PyPRP). Problems that are related only to Blender and modelling/texturing/animating/sound are located in the [[BlenderFAQ|Blender FAQ]]. | ||
− | '''''Common | + | '''''Common advices:'''''<BR> |
− | + | * Make sure you have the latest version of the tools.<BR> | |
− | + | * Make sure to always keep various back-ups of your Age files. Save your Age Blend file with incremental numbers (MyAge01.Blend, MyAge02.Blend etc)<BR> | |
− | + | * If you have enough space on your hard drive, keep a 'clean' back up installation of Uru. It is always useful for testing; or getting back missing/corrupted files for your 'regular' Uru installation.<BR> | |
− | + | * Whenever you have a problem with an Age, try to remember the last things you changed; the source of the problem is certainly here.<BR> | |
− | + | * If you sometimes use PyPRP 'Importer' make sure you do not use it to ''export'', and switch back to the regular PyPRP to export your Age. | |
− | + | * Patience is your best tool. :)<BR> | |
+ | * If all else fails, ask on the forum. | ||
+ | |||
= - PyPRP Setup Issues= | = - PyPRP Setup Issues= | ||
Line 19: | Line 20: | ||
Make sure that you copied the Python files out of the PyPRP distribution's "src" folder into your .blender/scripts directory. | Make sure that you copied the Python files out of the PyPRP distribution's "src" folder into your .blender/scripts directory. | ||
+ | |||
= - PyPRP export error messages= | = - PyPRP export error messages= | ||
Line 35: | Line 37: | ||
=="''ValueError: Need more than 0 values to unpack''"== | =="''ValueError: Need more than 0 values to unpack''"== | ||
− | This is most likely because your object use one (or more) vertex groups. | + | This is most likely because your object use one (or more) vertex groups. Unfortunately PyPRP doesn't like those; so you'll have to remove them. Select your object and go to the 'Editing' panel, and in the leftmost part of the panel there is the Vertex Groups area, click 'delete'. |
=="''ValueError: face has no texture values''"== | =="''ValueError: face has no texture values''"== | ||
Line 41: | Line 43: | ||
=="''Checking for installed Python... No installed Python found.''"== | =="''Checking for installed Python... No installed Python found.''"== | ||
− | There is a problem with Python. You need to install Python; find it here: | + | There is a problem with Python. You need to install Python; find it here: [[PyPRP:Installing]] |
=="''ImportError: No module named glob''"== | =="''ImportError: No module named glob''"== | ||
Line 47: | Line 49: | ||
=="''ImportError: No module named Image''"== | =="''ImportError: No module named Image''"== | ||
− | You need to install the Python Imaging Library. Find it here: | + | You need to install the Python Imaging Library. Find it here: [[PyPRP:Installing]] |
=="''ImportError: No module named yaml''"== | =="''ImportError: No module named yaml''"== | ||
− | You need to install YAML. Find it here: | + | You need to install YAML. Find it here: [[PyPRP:Installing]] |
− | =="''ImportError: No module <anything other than glob, image | + | =="''ImportError: No module named PyPRP''"== |
− | The python file | + | There is a problem with the PyPRP scripts installation. Make sure they are copied in the correct folder (see [[PyPRP:Installation]]). |
− | The default path for this : C:\Program Files\Blender\.blender\scripts | + | |
+ | =="''ImportError: No module <anything other than glob, image, yaml or PyPRP>''"== | ||
+ | The python file mentioned is missing. Make sure that the various PyPRP files are installed in the PyPRP subfolder of blender's script folder. | ||
+ | The default path for this: C:\Program Files\Blender\.blender\scripts, also see [[PyPRP:Installation]]. | ||
=="''UnboundLocalError: local variable 'col_r' referenced before assignment''"== | =="''UnboundLocalError: local variable 'col_r' referenced before assignment''"== | ||
Line 62: | Line 67: | ||
You may be trying to export an age from a .blend file that you opened within a temporary ZIP file folder (obtained by double-clicking on the ZIP file in Windows); and the plugin is unable to find the files it needs to in this temporary file. To fix this, exit Blender and right-click on the ZIP file, then choose Extract from the popup menu. Once the file has been extracted into a folder, double-click the .blend file and try again. | You may be trying to export an age from a .blend file that you opened within a temporary ZIP file folder (obtained by double-clicking on the ZIP file in Windows); and the plugin is unable to find the files it needs to in this temporary file. To fix this, exit Blender and right-click on the ZIP file, then choose Extract from the popup menu. Once the file has been extracted into a folder, double-click the .blend file and try again. | ||
− | =="Assertion Error: SRE module mismatch. == | + | =="Assertion Error: SRE module mismatch."== |
The system is picking up,there is something wrong with your Python file. | The system is picking up,there is something wrong with your Python file. | ||
Look if you have the latest version of Python. | Look if you have the latest version of Python. | ||
If you have the right version of Python, check you have no older version of Python standing on your computer. | If you have the right version of Python, check you have no older version of Python standing on your computer. | ||
+ | |||
+ | =="''ValueError: invalid literal for int() with base 10:''"== | ||
+ | An object in the scene has a string property with an incorrect value. It might be a 'Page_num' property, or any other string property which should have a number attached to it but has some other incorrect value/character instead of the number. | ||
= - Other PyPRP Issues= | = - Other PyPRP Issues= | ||
Line 72: | Line 80: | ||
Make sure that your AlcScript is in the proper text datablock called "AlcScript". This may seem obvious but it is a very common beginners mistake. | Make sure that your AlcScript is in the proper text datablock called "AlcScript". This may seem obvious but it is a very common beginners mistake. | ||
+ | |||
= - Uru problems/errors messages= | = - Uru problems/errors messages= | ||
=="''Files are corrupted or missing''"== | =="''Files are corrupted or missing''"== | ||
− | This is the most frequent problem and the easiest to fix. Some files are indeed corrupted or missing. If you have worked with the PRP files by hand then this is related to the .sum file of the Age either it is out of date and need to be updated (by any tool like | + | This is the most frequent problem and the easiest to fix. Some files are indeed corrupted or missing. If you have worked with the PRP files by hand then this is related to the .sum file of the Age either it is out of date and need to be updated (by any tool like PlasmaShop or UruFun - see [[Free_and_useful_tools_to_help_in_Age_writing#PRP_and_Python_Tools|PRP and Python Tools]]) or some of the PRP files for the Age are missing. Make sure you haven't deleted or renamed any files.<br> |
If you have this problem when you start Uru, this is a problem with the Personal Age files, or some of the other necessary Uru files. Make sure you haven't deleted or renamed any files. | If you have this problem when you start Uru, this is a problem with the Personal Age files, or some of the other necessary Uru files. Make sure you haven't deleted or renamed any files. | ||
Line 93: | Line 102: | ||
There are several possibilities: | There are several possibilities: | ||
− | 1) This is often related to a Sequence Prefix error. Have you registered a Sequence Prefix for your Age? Make sure it is not an existing number. Register your Age here: '''[[ | + | 1) This is often related to a Sequence Prefix error. Have you registered a Sequence Prefix for your Age? Make sure it is not an existing number. Register your Age here: '''[[TPOTS Sequence Prefixes]]'''. |
− | 2 | + | 2) PyPRP version 1.4.0 and above support dynamic shadows for all objects, not only the avatar. Unfortunately this is enabled by default in all Blender materials which means that if you haven't manually disabled it it is enabled for all the objects in your Age. This is too much to handle for most computers, and it may be the reason why your Age crashes.<BR> |
− | + | ||
− | + | ||
So if your haven't done it yet you will need to update all the materials in your Age and disable the 'Shadowbuf' button in the Material. (it is in the 'Links and Pipeline' pannel).To make things easier you can download [http://www.didanka.com/huru/antiShadow.py this python script] that will do it automatically. Install it in your Blender Scripts folder (where you installed PyPRP). Then in Blender open a Scripts window and in the ''Scripts'' menu go to ''Materials>Clear Shadbuf.'' | So if your haven't done it yet you will need to update all the materials in your Age and disable the 'Shadowbuf' button in the Material. (it is in the 'Links and Pipeline' pannel).To make things easier you can download [http://www.didanka.com/huru/antiShadow.py this python script] that will do it automatically. Install it in your Blender Scripts folder (where you installed PyPRP). Then in Blender open a Scripts window and in the ''Scripts'' menu go to ''Materials>Clear Shadbuf.'' | ||
Line 112: | Line 119: | ||
The stencil texture needs to have its 'CalcAlpha' flag turned on. | The stencil texture needs to have its 'CalcAlpha' flag turned on. | ||
− | |||
− | =="'' | + | = - Blender File Issues = |
− | + | ||
+ | =="''I want to move my Age project Blender file to a new computer''"== | ||
+ | There may be time when you want to move your Age's Blender file to another computer.<br> | ||
+ | Now, just copying the Blender file and your texture folder(s) will propbably not work as the file paths of your textures are unlikely to be identical on your new machine, and you will end up with the dreaded "pink" objects syndrome when you open the Blender file on your new machine. | ||
− | + | Now, there is an easy way for you to "fix" this problem of moving your blender file and /or texture folder to either a new machine (or maybe even a new directory (folder) on your current machine) by using Blenders "pack" function.** | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | Open the blender file on your current machine and then go to '''File/External Data/Pack into Blend file''' ... and then ''save your Blender file''. If you go and look at the size of your blender file now, you will see that it will have rocketed upwards in size (because it now has all your original, uncompressed texture files inside the blender file itself). | |
− | + | Now, move this new, bloated Blender file to its new location ... and then open it (from its new location) and go to '''File/External Data/ Unpack into files/use current directory (create if necessary)''' ... and Blender will create a new folder inside the folder where it now resides called "textures" ... and inside this folder will be all your (perfectly recreated) texture files... ... but, the best bit is that if you now go and look at the paths for your textures ... they now all point to this new folder ... . Even better, if you have your default Blender setting set to "Relative Paths Default" (pull down the very top menu bar ... where you set the sfx sound path) ... then all your textures will have the path "//textures\yourfile.png" | |
− | + | This method can also be used to bring all your (scattered) texture files into one texture folder (if you have used various different folders all over your hard drive to import textures) ... even if you are not moving your blend file to a new location or computer ... | |
− | + | NOTE:** you may want to try this method without "risking" your master blender file so ... BEFORE starting this process, open your master Blender file and then immediately save it with a new filename (e.g. MyAgePacked.blend) ... and then proceed with the packing process. This will also enable you to compare the size of the packed and unpacked blender files, so you will know that you have packed the file correctly. |
Latest revision as of 12:09, 3 May 2012
Disclaimer :
This FAQ is not exhaustive, it is always 'under construction', and many things might be missing. If you found a problem that is not covered here, please add it or post about it on the forum.
What is this FAQ?
For now this FAQ focuses on problems with Uru and the Tools (essentially PyPRP). Problems that are related only to Blender and modelling/texturing/animating/sound are located in the Blender FAQ.
Common advices:
- Make sure you have the latest version of the tools.
- Make sure to always keep various back-ups of your Age files. Save your Age Blend file with incremental numbers (MyAge01.Blend, MyAge02.Blend etc)
- If you have enough space on your hard drive, keep a 'clean' back up installation of Uru. It is always useful for testing; or getting back missing/corrupted files for your 'regular' Uru installation.
- Whenever you have a problem with an Age, try to remember the last things you changed; the source of the problem is certainly here.
- If you sometimes use PyPRP 'Importer' make sure you do not use it to export, and switch back to the regular PyPRP to export your Age.
- Patience is your best tool. :)
- If all else fails, ask on the forum.
Contents
- 1 - PyPRP Setup Issues
- 2 - PyPRP export error messages
- 2.1 "Blender Error Saying 'Object <object_name> Has no material. Export cannot continue!' "
- 2.2 "Blender error pop-up saying: Python script error: check console"
- 2.3 "Couldn't load image data in Blender"
- 2.4 "TypeError: 'NoneType' object is unsubscriptable"
- 2.5 "ValueError: Need more than 0 values to unpack"
- 2.6 "ValueError: face has no texture values"
- 2.7 "Checking for installed Python... No installed Python found."
- 2.8 "ImportError: No module named glob"
- 2.9 "ImportError: No module named Image"
- 2.10 "ImportError: No module named yaml"
- 2.11 "ImportError: No module named PyPRP"
- 2.12 "ImportError: No module <anything other than glob, image, yaml or PyPRP>"
- 2.13 "UnboundLocalError: local variable 'col_r' referenced before assignment"
- 2.14 "WindowsError: [Error 2] The system cannot find the path specified: 'C:\\DOCUME~1\\user\\LOCALS~1\\Temp\\..."
- 2.15 "Assertion Error: SRE module mismatch."
- 2.16 "ValueError: invalid literal for int() with base 10:"
- 3 - Other PyPRP Issues
- 4 - Uru problems/errors messages
- 4.1 "Files are corrupted or missing"
- 4.2 "Black screen when linking"
- 4.3 "Uru crashes on startup"
- 4.4 "Uru crashes to desktop when I try to load my Age"
- 4.5 "Uru crashes when I try to load my Age and displays a 'Stack Dump' window"
- 4.6 "My object doesn't appear in my Age, although I had no error on export."
- 4.7 "I'm using a stencil on my object's material to blend together two different textures, but I only see one."
- 5 - Blender File Issues
- PyPRP Setup Issues
PyPRP does not appear in the list of Exports
Make sure that you copied the Python files out of the PyPRP distribution's "src" folder into your .blender/scripts directory.
- PyPRP export error messages
"Blender Error Saying 'Object <object_name> Has no material. Export cannot continue!' "
That object does not have any materia. Either you delete that object, or you give it material. Giving it material does not mean setting bounds. To fix it, select the object, and in the buttons window, go in to object mode, (The red dot), and click on to the red dot right next to it, (same symbol as before), and click "Add New". That should fix it.
"Blender error pop-up saying: Python script error: check console"
The console is that small black and white window that opens up with Blender. So whenever you get that error open the console and look at what the last line says. That error may be listed in this FAQ, if it isn't ask on the forum.
"Couldn't load image data in Blender"
Sometimes Blender 'forget' some images. Solution: Reload the image in question in UV/Image window, or by simply selecting the problematic object, open a UV/Image window and hit 'F', this will display the image and fix the problem. This happens often.
"TypeError: 'NoneType' object is unsubscriptable"
I'm not sure why but this has to do with an object having multiple materials.. Try to remove materials from your objects.. If your objects needs several material try to subdvide it into more objects, one for each material.
"ValueError: Need more than 0 values to unpack"
This is most likely because your object use one (or more) vertex groups. Unfortunately PyPRP doesn't like those; so you'll have to remove them. Select your object and go to the 'Editing' panel, and in the leftmost part of the panel there is the Vertex Groups area, click 'delete'.
"ValueError: face has no texture values"
The mesh has a texture assigned but it is not yet UV mapped. Select the object and hit 'F' to edit its UV mapping.
"Checking for installed Python... No installed Python found."
There is a problem with Python. You need to install Python; find it here: PyPRP:Installing
"ImportError: No module named glob"
There is a problem with Python. Make sure it is properly installed, or re-install it.
"ImportError: No module named Image"
You need to install the Python Imaging Library. Find it here: PyPRP:Installing
"ImportError: No module named yaml"
You need to install YAML. Find it here: PyPRP:Installing
"ImportError: No module named PyPRP"
There is a problem with the PyPRP scripts installation. Make sure they are copied in the correct folder (see PyPRP:Installation).
"ImportError: No module <anything other than glob, image, yaml or PyPRP>"
The python file mentioned is missing. Make sure that the various PyPRP files are installed in the PyPRP subfolder of blender's script folder. The default path for this: C:\Program Files\Blender\.blender\scripts, also see PyPRP:Installation.
"UnboundLocalError: local variable 'col_r' referenced before assignment"
This error can be related to vertex painting if you are using an "alpha" layer but no "col" layer. If you do vertex alpha the "col" layer is also required, even if you don't use it. So make sure to have one.
"WindowsError: [Error 2] The system cannot find the path specified: 'C:\\DOCUME~1\\user\\LOCALS~1\\Temp\\..."
You may be trying to export an age from a .blend file that you opened within a temporary ZIP file folder (obtained by double-clicking on the ZIP file in Windows); and the plugin is unable to find the files it needs to in this temporary file. To fix this, exit Blender and right-click on the ZIP file, then choose Extract from the popup menu. Once the file has been extracted into a folder, double-click the .blend file and try again.
"Assertion Error: SRE module mismatch."
The system is picking up,there is something wrong with your Python file. Look if you have the latest version of Python. If you have the right version of Python, check you have no older version of Python standing on your computer.
"ValueError: invalid literal for int() with base 10:"
An object in the scene has a string property with an incorrect value. It might be a 'Page_num' property, or any other string property which should have a number attached to it but has some other incorrect value/character instead of the number.
- Other PyPRP Issues
PyPRP ignores my AlcScript at export
Make sure that your AlcScript is in the proper text datablock called "AlcScript". This may seem obvious but it is a very common beginners mistake.
- Uru problems/errors messages
"Files are corrupted or missing"
This is the most frequent problem and the easiest to fix. Some files are indeed corrupted or missing. If you have worked with the PRP files by hand then this is related to the .sum file of the Age either it is out of date and need to be updated (by any tool like PlasmaShop or UruFun - see PRP and Python Tools) or some of the PRP files for the Age are missing. Make sure you haven't deleted or renamed any files.
If you have this problem when you start Uru, this is a problem with the Personal Age files, or some of the other necessary Uru files. Make sure you haven't deleted or renamed any files.
"Black screen when linking"
There are several possibilities:
It might be a problem with the linking point for the Age. Either you don't have one, or it is placed in an improper place (inside a wall, under the floor etc) or it is incorrectly named.
This could also be a problem with the .Fni file. If it is corrupted in any way some graphic cards will display a totally black fog in the Age instead of the fog you have set in the .fni file. Make sure it is not corrupted in any way. The best way to avoid this is to create the .fni file in Blender, and never touch it outside of Blender unless you know exactly what you are doing.
Just incase you don't have the fni file, you can get it by exporting the age again, but instead of clicking on "Generate Age", click on "As Full Age".
< This section needs to be expanded >
"Uru crashes on startup"
This is most likely related to the lastest Age you have added or modified. Try removing it and launch Uru again. If this solves the problem, then something is wrong with this Age; and if you have a .Pak Python file for this Age it is most likely the problem. Make sure it is properly compiled, not corrupted, and doesn't have any problem of any kind.
"Uru crashes to desktop when I try to load my Age"
There are several possibilities:
1) This is often related to a Sequence Prefix error. Have you registered a Sequence Prefix for your Age? Make sure it is not an existing number. Register your Age here: TPOTS Sequence Prefixes.
2) PyPRP version 1.4.0 and above support dynamic shadows for all objects, not only the avatar. Unfortunately this is enabled by default in all Blender materials which means that if you haven't manually disabled it it is enabled for all the objects in your Age. This is too much to handle for most computers, and it may be the reason why your Age crashes.
So if your haven't done it yet you will need to update all the materials in your Age and disable the 'Shadowbuf' button in the Material. (it is in the 'Links and Pipeline' pannel).To make things easier you can download this python script that will do it automatically. Install it in your Blender Scripts folder (where you installed PyPRP). Then in Blender open a Scripts window and in the Scripts menu go to Materials>Clear Shadbuf.
"Uru crashes when I try to load my Age and displays a 'Stack Dump' window"
Unfortunately there could be many sources for this.. A very common error which causes this is having an animated object that is not an actor; but it could be many other things. Try to remember the last things you changed to the Age or to Uru before that happened; the source of the problem is certainly here. It may also be because of a Python problem; if you use Python in your Age check that there is nothing wrong with the code or with the .pak files.
Users can send stack dumps to Tahgtahv. Browse to your game directory. Include the contents of log/stackdump.log (if it exists) along with a description of the problem and he will look into it.
"My object doesn't appear in my Age, although I had no error on export."
Check that your object isn't assigned a non-existing page_num property. It could also be a problem with the normals, in edit mode check that your object's normals are not inverted.
"I'm using a stencil on my object's material to blend together two different textures, but I only see one."
The stencil texture needs to have its 'CalcAlpha' flag turned on.
- Blender File Issues
"I want to move my Age project Blender file to a new computer"
There may be time when you want to move your Age's Blender file to another computer.
Now, just copying the Blender file and your texture folder(s) will propbably not work as the file paths of your textures are unlikely to be identical on your new machine, and you will end up with the dreaded "pink" objects syndrome when you open the Blender file on your new machine.
Now, there is an easy way for you to "fix" this problem of moving your blender file and /or texture folder to either a new machine (or maybe even a new directory (folder) on your current machine) by using Blenders "pack" function.**
Open the blender file on your current machine and then go to File/External Data/Pack into Blend file ... and then save your Blender file. If you go and look at the size of your blender file now, you will see that it will have rocketed upwards in size (because it now has all your original, uncompressed texture files inside the blender file itself).
Now, move this new, bloated Blender file to its new location ... and then open it (from its new location) and go to File/External Data/ Unpack into files/use current directory (create if necessary) ... and Blender will create a new folder inside the folder where it now resides called "textures" ... and inside this folder will be all your (perfectly recreated) texture files... ... but, the best bit is that if you now go and look at the paths for your textures ... they now all point to this new folder ... . Even better, if you have your default Blender setting set to "Relative Paths Default" (pull down the very top menu bar ... where you set the sfx sound path) ... then all your textures will have the path "//textures\yourfile.png"
This method can also be used to bring all your (scattered) texture files into one texture folder (if you have used various different folders all over your hard drive to import textures) ... even if you are not moving your blend file to a new location or computer ...
NOTE:** you may want to try this method without "risking" your master blender file so ... BEFORE starting this process, open your master Blender file and then immediately save it with a new filename (e.g. MyAgePacked.blend) ... and then proceed with the packing process. This will also enable you to compare the size of the packed and unpacked blender files, so you will know that you have packed the file correctly.