
Introduction
With Cinema 4D R20, C.O.F.F.E.E. scripting language has been removed.
The C.O.F.F.E.E. Filter plugin is supposed to help locate scenes, which are making use of C.O.F.F.E.E. in any way, and furthermore to provide easy access to the involved C.O.F.F.E.E. code.
C.O.F.F.E.E. Filter plugin will not convert or port existing C.O.F.F.E.E. code to Python (or anything else). It just provides means to locate scenes containing C.O.F.F.E.E. and an easy way to get to the code inside of the scene.C.O.F.F.E.E. Filter can and will not erase files.
C.O.F.F.E.E. Filter will not overwrite files.
General Workflow within Cinema 4D
General Workflow
The general workflow consists of two main steps:
- Importing scene files
- Optionally filtering and selecting the results of the import
- Clicking an entity’s icon in order to open the scene an see the C.O.F.F.E.E. code in Attribute Manager
Where to Find the Plugin
C.O.F.F.E.E Filter can be found in the Plugins menu:

Main Dialog
The main dialog looks like so:
 - [Untitled 1] - Main.png)
Menus
File

Open File
Import a single .c4d scene file.
Open folder
Import all .c4d scene files that are in a selected directory.
Open one level of subfolders
Import all .c4d scene files that are in a given directory and one level below. This option is meant for people with a project folder, which then contains sub-directories for different projects, but who do not want to scan any backup sub-directories possibly contained in the actual project directories..
Open all subfolders
Import all .c4d scene files that are in a given directory (including all sub-directories).
It’s also possible to drag files or folders from Explorer or Finder onto this dialog in order to get them imported.
Example of a directory tree and the differences between all three options:

Open current Document
Import the currently active scene. The document needs a name, so it either got loaded or needs to be saved at least one time.
Open all opened Document
Import all open scenes. The documents need to have names, so either got loaded or need to be saved at least one time.
Content Browser
Import all items from your personal content preset library to the dialog.
While we use this plugin internally to scan our own content libraries, these are excluded in the published version. This was not done to hide anything, but to reduce the results to those relevant for a user. The content libraries delivered with R20 will not contain any C.O.F.F.E.E. scene.
Search COFFEE plugins
Import COFFEE plugins from current Cinema 4D instance located in theses directories:
- Cinema 4D plugins folder in program installation folder
- Cinema 4D plugins folder in user’s home
- Path(s) defined in C4D_PLUGINS_DIR environment variable
Edit

Remove
Remove entries from result list according to the option chosen (see below). It will not delete any files.
COFFEE found
Remove results which contain at least one C.O.F.F.E.E. element. These are usually scene files which need action in order to work properly in R20.
No COFFEE
Remove results which do not contain any C.O.F.F.E.E. elements.
Preset
Remove results from a Content Browser library scan.
Plugin
Remove results from Plugin scan.
Filtering Results
In order to get a quick overview of the results of an import operation, one can easily hide certain groups of files.

COFFEE found
Yellow – Display results which contain at least one C.O.F.F.E.E. element, most likely results which need action in order to work properly in R20.
No COFFEE
Green – Display results which contain no C.O.F.F.E.E. elements at all, probably candidates to be removed from the result list.
Accessing C.O.F.F.E.E. code
After one or multiple scene files have been imported, they are displayed in the result list, as shown below.
Click on the icon allow you to directly access to the C.O.F.F.E.E. elements.

Refresh
Refresh the status of a file. For example after removing a C.O.F.F.E.E. node.
If this file is currently open in Cinema 4D, the plugin will use this document and not the one from disk.
Open
Open the given scene file in Cinema 4D.
View in Explorer/Finder
Open the given scene in Windows Explorer or Finder on macOS.
Remove
Remove the file from the result list. The file will not be deleted, just removed from the list.
List of C.O.F.F.E.E. usage
Clicking an icon will open the file if needed and the C.O.F.F.E.E element specific C.O.F.F.E.E. element will be selected so it is shown in the Attribute Manager.
If a C.O.F.F.E.E. node is within an Xpresso tag and this node is within a locked xgroup only the group is displayed. Locked nodes/xgroups will not expose code.
General Workflow on Command Line
The general workflow from command line is pretty much the same as the one described above.
Basically one sets a file/folder to scan and it will write the result list with C.O.F.F.E.E. elements to a file.
In contrast to the UI command of this plugin, the command line can be used with version of Cinema 4D down to R16.
Command Line Options
All command line options need to be enclosed with double quotes.
Option |
Description |
-COFFEEFilter |
This argument needs to be the first one.
Scan file/folder specified directly next to this parameter: -COFFEEFilter ‘FILE_OR_FOLDER_PATH’ |
Import options (only one possible)
-Folder
-OneLevel
-SubFolder |
If path to process is a file this option is ignored.
-Folder (default behavior): Process only the content of the folder, same as described for File Menu => Open Folder
-OneLevel: Process folder and one level of sub-folders, same as described for File Menu => Open one level of subfolder
-SubFolder: Process folder and all sub-folders, same as described for File Menu => Open all subfolders |
-CheckPlugins |
Process plugins folder, same as File Menu => Search COFFEE plugins |
-OnlySceneWithCoffee |
Only scenes with C.O.F.F.E.E. will be in result list. |
-Output |
Write result list to a file, specified directly next to this parameter -Output ‘FILEPATH’
The output format depends on the -Json option.
If the file can’t be written for any reason, results are printed to the console. |
-OverwriteOutput |
Allow to overwrite the result list file. If this option is not set and the result list file can not be written, results are printed to the console. |
-Json |
The result list will be in JSON format. |
Example 1
Check all files from {your path}/CS Cluster/ (including its first level of sub-folders) and plugins folders, write the result list to {your path}/result.txt and allow to overwrite this resulting text file (in case the operation is run more than once).
CINEMA 4D.exe "-COFFEEFilter '{your path}/CS Cluster/' -SubFolder -Output '{your path}/result.txt' -OverwriteOutput -CheckPlugins"
Example 2
Check all files from {your path}/CS Cluster/ (including its first level of sub-folders) and plugins folders, write the result list to {your path}/CS Cluster/result.json and allow to overwrite this resulting text file (in case the operation is run more than once).
CommandLine.exe "-COFFEEFilter '{your path}/CS Cluster/' -SubFolder -Output '{your path}/CS Cluster/result.json' -Json -OverwriteOutput -CheckPlugins"
Example 2 Output
Write result list in JSON file format to: {your path}/CS Cluster/result.json
[
{
"path": "{your path}\CS Cluster\CS Cluster.c4d",
"coffee": [
"CS-Cluster-XPresso-XGroup::C.O.F.F.E.E.-C.O.F.F.E.E.",
"CS-Cluster-XPresso-XGroup::C.O.F.F.E.E.-C.O.F.F.E.E.",
"CS-Cluster-XPresso-XGroup::Framestart-Framestart",
"CS-Cluster-XPresso-XGroup::RIGHT Instance Maker-RIGHT Instance Maker",
"CS-Cluster-XPresso-XGroup::LEFT Instance Maker-LEFT Instance Maker"
]
},
{
"path": "{c4d installation path}\plugins\Commentator\commentator.cob",
"coffee": [
"commentator.cob"
]
},
{
"path": "{c4d installation path}\plugins\cinema4dsdk\res\scene\stairs.c4d",
"coffee": []
},
]
Limitations
- Content Browser scanning is not available through command line.
- Xpresso presets can not be scanned. If you need to check them, create an Xpresso tag and drag all your presets into it, save the scene, then run the plugin.
- While loading some files a message dialog may open for example in case of missing assets from Substance module. The plugin will hang until an user interaction. There is no way for the plugin to bypass these messages.
Requirements
For use as a Command inside of Cinema 4D user interface, Cinema 4D R19 (Windows or Mac) is required.
For use on the command line (batch mode), Cinema 4D R16 (Windows or Mac) is required.
Download
Terms of Use
Acceptance of Terms of Use of this site (“Site”) constitutes a legal agreement between you and MAXON Computer GmbH. By accessing, browsing and/or using this Site you acknowledge that you have read, understood, and agree to be bound by its Terms of Use. Please review the Terms of Use. If you do not agree to these terms, do not use this Site and the materials provided on this Site.
Copyright Information
The copyright on all material provided on this Site is held by MAXON Computer GmbH and its subsidiaries (MAXON Computer Inc. and MAXON Computer Ltd.) or by the original creator of the material. Except as stated herein, none of the material may be copied, reproduced, distributed, republished, downloaded, displayed, posted or transmitted in any form or by any means, including, but not limited to, electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of MAXON Computer or the copyright owner. Permission is granted to display, copy, distribute and download the materials on this Site for personal, non-commercial use only provided you do not modify the materials and that you retain all copyright and other proprietary notices contained in the materials. You also may not, without MAXON Computer’s permission, use the materials for the development, production or marketing of other materials, works or media of any kind and/or “mirror” any material contained on this Site on any other server. This permission terminates automatically if you breach any of these terms. Upon termination, you will immediately destroy any downloaded and printed materials. Any unauthorized use of any material contained on this Site may violate copyright laws, trademark laws, the laws of privacy and publicity, and communications regulations and statutes.
Privacy Policy
The protection of personal information submitted to us is very important. We strictly adhere to prevailing German Data Protection Act (BDSG), the German Telemedia Act (TMG) and other privacy protection provisions of the Federal Republic of Germany. For privacy protection issues outside of Germany we will, of course, adhere to respective privacy protection provisions.
Your personal information is transmitted via SSL (a network protocol for the secure transmission of data) in encrypted form. The Site is protected against damage, destruction or unauthorized access.
Object of Privacy Policy
Object of the Privacy Policy are details regarding personal information or personal or factual circumstances about a specific determinable person according to § 3 Abs. 1. BDSG. Included is information such as name, postal address, e-mail address or telephone number.
Scope of Data Gathering, Storage and Use
We gather and store your personal information for the purposes of rendering services or as necessary for contractual fulfillment. Your information is used by MAXON to make using the Site and the materials as pleasant and comfortable as possible.
Your personal information will not be given to third parties without your expressed consent unless it is required for providing services or contractual fulfillment. It may, however, be necessary to supply your personal information to certified MAXON partner companies that MAXON implements to provide certain services. We will require that the recipient of the personal information agrees to process such information in compliance with our Privacy Policy and applicable data protection laws.
Transmission of personal information to authorized government institutions or authorities will only be done according to the statutory obligation to provide such information or if obliged to do so in accordance with a court order.
Acceptance
By accessing, browsing and/or using this Site, you agree to comply with all applicable laws and regulations, including the export and re-export control laws and regulations of Germany, the United States of America and the United Kingdom. This Site is controlled and operated by MAXON Computer from its offices and servers within Germany, the United States, and the United Kingdom. MAXON Computer makes no representation that materials on the Site are appropriate or available for use in other locations. Access to the materials on this Site from territories where their contents are illegal is prohibited. Those who choose to access this Site from other locations do so on their own initiative and are responsible for compliance with applicable local laws.
Trademarks
The trademarks, service marks and logos (the “Trademarks”) used and displayed on this Site are registered and unregistered trademarks of MAXON Computer and others. Nothing on this Site should be construed as granting, by implication, estoppel, or otherwise, any license or right to use any Trademark displayed on the Site without the written permission of the Trademark owner. MAXON Computer aggressively enforces its intellectual property rights to the fullest extent of the law. The name of MAXON Computer or the MAXON Computer logo may not be used in any form, including advertising or public display pertaining to distribution of materials on this Site without prior written permission. MAXON Computer prohibits use of the MAXON Computer logo as a “hot” link to any MAXON Computer site unless written approval to establish such a link is granted in advance by MAXON Computer. Any questions concerning the use of Trademarks owned by MAXON Computer should be referred to MAXON Computer Inc., 2640 Lavery court suite a, Newbury Park, CA 91320, USA, tel: 805-376-3333 or MAXON Computer GmbH, Max-Planck-str. 20, D-61381 Friedrichsdorf, Germany, or MAXON Computer Ltd., The old school Greenfield, Bedford, MK45 5DE, England.
Disclaimer of Warranty
This Site and the materials on this Site are provided “as is” without warranties of any kind either express or implied. The Site and the materials may be incorrect, incomplete and may have defects that could cause program malfunctions, program crashes, system failures and loss of data. The Site and the materials may not be merchantable, fit for a particular purpose, or non-infringing. MAXON Computer does not warrant or make any representations regarding the use, validity, accuracy, or reliability of, or the results of the use of the Site and the materials on this Site or any sites linked to this Site. MAXON Computer is under no obligation to provide technical maintenance and support, to rectify defects and to restore failed systems and lost data.
Limitation of Liability
MAXON Computer shall be liable without limitations (1) in case of intent and gross negligence; (2) in case of injuries to life, body or health; (3) pursuant to the terms of the German Product Liability Act; and (4) under a guarantee granted by MAXON Computer. MAXON Computer’s liability for slightly negligent breaches of cardinal duties shall be limited to such damage which was foreseeable and typical for the intended use of the Site and the materials. Cardinal duties are duties of MAXON Computer which enable the use of the Site and the materials and which you may therefore rely on. Any other liability of MAXON Computer is excluded. If your use of materials from this Site results in the need for servicing, repair or correction of equipment or data, you assume any costs thereof.
Transmissions
Any material, information or idea you transmit to or post on this Site by any means will be treated as non-confidential and may be used by MAXON Computer or its affiliates to operate the Site and to provide the materials. You are prohibited from posting or transmitting to or from this Site any unlawful, threatening, libelous, defamatory, obscene, inflammatory, pornographic, profane or any other material that could give rise to any civil or criminal liability under the law.
Term of Use Revisions
MAXON Computer may at any time revise these Terms of Use. You may access and review the revised terms on this Site, and your continued use of this Site means that you accept those revised terms.
Liability notice
Despite thorough examination of contents, MAXON Computer assumes no liability for the content of external links. The operators of the linked sites are exclusively responsible for their content.
Applicable Law and Jurisdiction
The Terms of Use are governed by the laws of Germany, but excluding the principles of conflict of laws and the United Nation Convention on the International Sale of Goods (CISG). You agree to the exclusive jurisdiction of the competent courts of Frankfurt am Main, Germany, in respect of any proceeding, suit or action arising out of or in connection with these Terms of Use, this Site and/or the materials.
Legal Notice
MAXON Computer GmbH
Max-Planck-Str. 20
61381 Friedrichsdorf
Germany
Phone: +49 (0) 6172 / 59 06 0
Fax: +49 (0) 6172 / 59 06 30
General information: info@maxon.de
Sales & Marketing: sales@maxon.de
Press: presse@maxon.de
Authorized company representatives
David McGavran
Court of registration: Amtsgericht Bad Homburg v. d. Höhe
Registration number: HRB 6049
VAT ID number according to § 27 a sales tax law: DE 113864088
Installation
Unzip the downloaded archive to Cinema 4D’s default plugin folder.
Support
Provide your bug reports, test scenes or ideas by writing an email to labs-at-maxon-dot-net
Thank you
I have R20 version, I downloaded the coffee plugin and it has a red x through it. It does not work and I still get the prompt to install coffee. Not sure what i’ve done wrong, I made a plugins folder and went into preferences to select the plugins folder.
I HAVE THE SAME PROBLEM.
tks bro it’s realy great
我是C4D学员,是从课堂上的相关连接进来的,请发C4D教材中的相关手插件,谢谢!
Needed! solved the emergency
中国浙江
thank you
Thank you
thx!
thank you
I just installed this and am still getting the alert box to install it.
ytn
Hi, I’m learning c4d on r21. I’m doing tutorials on lynda and when I work in tutorial projects I constantly get “c.o.f.f.e.e elements no longer supported”. I’m going insane over it. Can’t figure out how to either delete the nodes/elements or turn the warnings off.
Is there a quick way of deleting all elements effected?
Would be so happy to get your help on this
I agree this Olle, This should be part worked out and included automatically of all upgrades!
Hi. I’m trying to run the command line version with C4D R18. For testing there’s a folder ‘testcoffee’ on my desktop containing a .c4d that uses coffee. Here’s the command I use (based on Example 1).
“C:\Program Files\MAXON\CINEMA 4D R18\CINEMA 4D.exe” “-COFFEEFilter ‘C:\Users\nick\Desktop\testcoffee\’ -SubFolder -Output ‘C:\Users\nick\Desktop\testcoffee\result.txt’ -OverwriteOutput -CheckPlugins”
Unfortunately nothing happens. Can you please help me and point out the mistake I’m making?
Thanks
Why would you need to do this with R18? COFFEE is still apart of C4D R18.
need